io.github.365xbusiness/vigo-mcp
AI-powered Hong Kong SFC regulatory intelligence. Bilingual EN/ZH compliance queries.
Ask AI about io.github.365xbusiness/vigo-mcp
Powered by Claude ยท Grounded in docs
I know everything about io.github.365xbusiness/vigo-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
VIGO โ The First MCP Server for Financial Regulatory Intelligence
Regulatory Intelligence Expert ยท Bilingual AI Agent for Hong Kong SFC Regulations
By OrphicOne ยท English & ็น้ซไธญๆ ยท Continuously Updated Knowledge Base
What is VIGO?
VIGO (้ ่ฆ ยท ๆดๅฏ ยท ๆฒป็ ยท ๅชๅ) is a specialized financial regulatory intelligence AI agent โ and the industry's first MCP server dedicated to financial regulatory intelligence in any jurisdiction.
At its core, VIGO is a regulatory intelligence expert: deeply versed in Hong Kong SFC regulations, enforcement history, licensing requirements, and AML/CFT rules. But VIGO is more than a compliance encyclopedia. It is a business-aware compliance navigator โ an AI that understands how compliance intersects with business strategy, capital structures, and market reality.
Compliance is the floor. Business is the ceiling. VIGO helps you build both.
V.I.G.O. โ The Four Dimensions
| Dimension | ไธญๆ | Capability | |
|---|---|---|---|
| V | Visionary | ้ ่ฆ | Capital path planning โ IPO structures (18A/18C, SPAC), market positioning |
| I | Insight | ๆดๅฏ | Architecture design โ Red-chip, VIE, LPF, OFC, SPC structures |
| G | Governance | ๆฒป็ | Regulatory mastery โ SFC licensing (Type 1-13), FRR, AML/CTF |
| O | Optimization | ๅชๅ | Cost-effective solutions โ market pricing, talent policy, ROI |
Why VIGO instead of asking Claude/ChatGPT directly?
| General AI | VIGO | |
|---|---|---|
| Data | Frozen at training cutoff | Continuously updated โ daily SFC sync + weekly HKMA/HKEX + monthly industry scan |
| Accuracy | Approximate, details often wrong | Precise โ based on original regulatory documents with three-tier verification |
| Sources | None | Every answer includes official SFC document links with authority scores |
| Depth | Overview-level | Exam papers, exemptions, capital rules, enforcement details, fee benchmarks |
| Enforcement | Almost none | Searchable fines, bans, suspensions โ 28 structured enforcement records |
| Perspective | Generic | Connects compliance requirements to business value (Iceberg Strategy) |
| Quality | No quality signals | Three-tier verification: GOLD (65%) / SILVER (35%) โ World-Class metrics |
| Chinese | Generic translation | Professional regulatory terminology (็น้ซไธญๆ) |
| Intelligence | Static | Dual-model routing, 9-type query classification, self-correction engine |
Asking ChatGPT about SFC regulations is like asking a smart friend โ they roughly know. Asking VIGO is like consulting a senior compliance partner who knows every circular, every enforcement action, every licensing nuance, and always connects compliance back to your business objectives.
Quick Start
Claude (Web, Desktop, Mobile)
Settings โ Connectors โ Add custom connector โ paste:
https://lsoatzzwpltpydwyfqqv.supabase.co/functions/v1/vigo-mcp
Claude will automatically invoke VIGO when you ask SFC compliance questions.
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"vigo": {
"type": "streamableHttp",
"url": "https://lsoatzzwpltpydwyfqqv.supabase.co/functions/v1/vigo-mcp"
}
}
}
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"vigo": {
"type": "streamableHttp",
"url": "https://lsoatzzwpltpydwyfqqv.supabase.co/functions/v1/vigo-mcp"
}
}
}
Claude Code
claude mcp add --transport http vigo https://lsoatzzwpltpydwyfqqv.supabase.co/functions/v1/vigo-mcp
ChatGPT Desktop
{
"mcpServers": {
"vigo": {
"url": "https://lsoatzzwpltpydwyfqqv.supabase.co/functions/v1/vigo-mcp"
}
}
}
Tools
VIGO provides 6 tools (4 read-only query tools + 2 analytical tools):
query_regulation
Ask any question about SFC regulations. Covers all license types, VATP/ASPIRe framework, AML/CFT, exams, CPD/CPT, and more. Bilingual โ responds in whatever language you ask.
| Parameter | Required | Description |
|---|---|---|
question | Yes | Your regulatory question |
language | No | "en", "zh", or "auto" (default) |
license_type | No | Filter: "Type 1" through "Type 13" |
search_enforcement
Search SFC enforcement actions โ fines, suspensions, bans, and prosecutions.
| Parameter | Required | Description |
|---|---|---|
query | Yes | Company name, person, or violation type |
year | No | Filter by year (e.g. 2025) |
get_license_guide
Comprehensive guide for any SFC license type: exams, capital, fit-and-proper, CPD.
| Parameter | Required | Description |
|---|---|---|
license_type | Yes | "Type 1" through "Type 13" |
aspect | No | "overview", "exam", "capital", "fit_and_proper" |
latest_updates
Latest SFC regulatory updates: circulars, enforcement, VATP developments, consultations.
| Parameter | Required | Description |
|---|---|---|
category | No | "circular", "enforcement", "vatp", "consultation", "all" |
count | No | Number of results, 1โ10 (default: 5) |
compliance_check
Perform a compliance health check for a licensed corporation. Input company profile, get a multi-dimensional compliance risk assessment.
| Parameter | Required | Description |
|---|---|---|
license_types | Yes | License types held, e.g. ["Type 1", "Type 9"] |
num_ros | No | Number of Responsible Officers |
num_staff | No | Total number of staff |
aum | No | Assets under management, e.g. "500M HKD" |
business_areas | No | Business areas, e.g. ["securities dealing", "asset management"] |
has_vatp | No | Whether the firm deals with virtual assets |
risk_assessment
Assess compliance risk of a planned business activity. Returns Red/Yellow/Green risk rating with regulatory basis and recommended actions.
| Parameter | Required | Description |
|---|---|---|
description | Yes | Description of the planned business activity |
license_types | No | Relevant license types |
urgency | No | "immediate", "planned", "exploratory" |
Example Queries
Licensing & Exams
What exams do I need for an SFC Type 9 (Asset Management) license?
โ Complete exam structure, pass marks, exemption conditions, official links
Enforcement Intelligence
Search for SFC enforcement actions related to AML in 2025
โ Matching cases with companies, penalties, regulatory basis, official notices
Bilingual Regulatory Updates
SFCๆๆฐ็้ๅฝๅ็ฃ็ฎกๅๆ
ๆฏไป้บผ๏ผ
โ ๆๆฐ้ๅฝๅ่กจ๏ผๅซๅ่็ทจ่ใๆฅๆใไธป้กใๅฎๆนๆไปถ้ๆฅ๏ผ็น้ซไธญๆ๏ผ
Compliance Health Check
Run a compliance check for a Type 1 + Type 9 firm with 3 ROs, 25 staff, 2B HKD AUM
โ FRR capital assessment, RO configuration review, regulatory focus areas
Risk Assessment
We want to launch a tokenized fund product for retail investors in Hong Kong
โ Red/Yellow/Green rating, regulatory basis, recommended actions, timeline
Fee & Market Intelligence
What are the current RO retainer fees and shell company prices?
โ Structured fee benchmarks from vigo_fee_benchmarks with latest market data
Knowledge Base
VIGO's intelligence is powered by a structured, continuously updated knowledge base with 6,381 verified knowledge chunks covering 26 years of SFC regulatory history:
Data Sources
Official Sources (6 endpoints + HKMA)
- SFC Circulars, Enforcement News, Consultation Papers
- VATP/Virtual Asset regulatory updates
- Press Releases and policy announcements
- HKMA Joint Circulars (auto-filtered for SFC-relevant content)
Foundational Documents (35 + 5 Thematic Reports)
- 12 Codes + 16 Guidelines + 3 Laws (SFO, SFF, AMLO) + 2 Handbooks + 2 HKEX Listing Rules
- 5 SFC Thematic Inspection Reports (Cybersecurity, Sponsor Business, Prime Services, Securities Margin Financing, Alternative Liquidity Pools)
Industry Intelligence (17 sources)
- International Law Firms (6): Charltons, Deacons, KWM, Sidley Austin, Linklaters, Clifford Chance
- Local Law Firms (3): ONC Lawyers, Stevenson Wong, Paradox Management
- Big 4 (4): Deloitte HK, PwC HK, EY HK, KPMG HK
- Compliance Consultants (2): CompliancePlus, Waystone
- Compliance Tech (2): Heinbro, BBCIncorp
v7.0 Structured Data (76 records)
| Table | Records | Content |
|---|---|---|
vigo_enforcement | 28 | Structured enforcement records (entity, violations, penalties, bans) |
vigo_regulations | 21 | Structured regulation documents (categories, effective dates, requirements) |
vigo_fee_benchmarks | 25 | Fee benchmarks (RO retainers, SFC fees, application costs) |
vigo_license_market | 2 | License market pricing (shell prices, transaction data) |
Coverage
- All SFC license types (Type 1โ13) and VATP licensing
- AML/CFT guidelines and enforcement case history
- Exam requirements, CPD/CPT rules, fit-and-proper criteria
- FRR capital requirements and operational compliance
- HKEX Main Board and GEM Listing Rules
- Cross-border: Stock Connect, MRF Fund Mutual Recognition, WMC
Quality Assurance
| Metric | Target | Actual | Status |
|---|---|---|---|
| Duplication rate | โค 2% | 1.0% | โ World-Class |
| GOLD verification rate | โฅ 60% | 64.8% (4,155 records) | โ World-Class |
| Freshness score | โฅ 0.95 | 0.987 | โ World-Class |
| Authority score | โฅ 80 | 85.6 | โ World-Class |
| Recall@5 | โฅ 70% | 80% | โ World-Class |
| MRR | โฅ 0.700 | 0.800 | โ World-Class |
Verification Grading
- ๐ฅ GOLD (authority โฅ 90): 4,155 records (65%) โ SFC official, HKMA, HKEX
- ๐ฅ SILVER (authority โฅ 65): 2,226 records (35%) โ Law firms, Big 4, consultants
- ๐ฅ BRONZE (authority < 65): 0 records
Quality Framework
- Three-layer deduplication: L1 ref_id exact match โ L2 SHA-256 content hash โ L3 semantic similarity > 0.92
- Six-point content validation on every chunk before upload
- Five-tier authority scoring: Primary legislation (100) โ Senior speeches/Big 4 (80-90) โ Specialist firms (68-75) โ Brokers/media (50-55) โ Social/AI (5-25)
- Bilingual: every entry exists in English and Traditional Chinese
v7.0 Intelligent Engine
Six-Layer Retrieval Pipeline
Query โ [Layer 1] Query Router (9 route types)
โ [Layer 2] Hybrid Retrieval (Dense cosine@0.25 top20 + BM25 sparse top15)
โ [Layer 3] RRF Fusion (K=60, structured results get 1.5ร boost)
โ [Layer 4] Score Fusion (rerankร0.50 + verificationร0.20 + freshness + authority)
โ [Layer 5] Diversity Filter (min 3 sources, max 2 per source, cross-contamination penalty)
โ [Layer 6] Dynamic TopK (6-8 results based on query complexity)
โ Answer with citations
Dual-Model Routing
| Model | Use Case | Trigger |
|---|---|---|
| GPT-4o-mini | Fast lookups, simple facts | capital_requirement / fee_benchmark / enforcement_lookup / license_market |
| DeepSeek Chat | Deep analysis, regulatory interpretation | comparison / how_to / general / latest_update |
Built-in fallback: if GPT-4o-mini fails โ auto-switch to DeepSeek.
9 Query Route Types
Each route type has optimised search weights (freshness, authority) and strategy (structured_lookup / semantic / multi_query / hybrid):
capital_requirement ยท license_market ยท enforcement_lookup ยท fee_benchmark ยท latest_update ยท comparison ยท how_to ยท general ยท unknown
Six-Layer Anti-Hallucination
- LICENSE_TYPE_MAP hardcoded โ all SFC exam subjects verified against HKSI website 2026
- System Prompt strict instructions โ never supplement specific numbers from training data
- Reranking filter โ demote non-matching license type documents
- Verification grade weighting โ GOLD > SILVER > BRONZE
- Cross-contamination penalty โ -0.05 for mismatched license documents
- Diversity filter โ force minimum 3 different sources
Iceberg Strategy (Response Philosophy)
| Layer | Description | Role |
|---|---|---|
| Step 1: Direct Answer | Clear numbers, legal provisions, processes | Compliance Officer |
| Step 2: Market Calibration | Reference latest market data and fee benchmarks | Analyst |
| Step 3: Strategic Extension | "From an Optimization perspective, also consider..." | Architect |
Autonomous Operations
v7.0 achieves fully autonomous operations with zero manual intervention:
pg_cron Scheduled Tasks (4)
| Task | Schedule | Function |
|---|---|---|
| Daily freshness update | 0 3 * * * | Recalculate freshness_score |
| Weekly duplicate detection | 0 4 * * 0 | Flag is_duplicate |
| Monthly statistics | 0 5 1 * * | Update vigo_stats |
| Quarterly cleanup | 0 6 1 1,4,7,10 * | Clean expired memory |
GitHub Actions Three-Tier Scheduling
| Workflow | Schedule | Tasks | Duration |
|---|---|---|---|
vigo-daily.yml | Sun-Thu 23:00 UTC | Mode 1 daily sync + Mode 14a conflict detection | ~16 min |
vigo-weekly.yml | Sun 00:00 UTC | Mode 13e data quality + Mode 14e full inspection | ~45 min |
vigo-monthly.yml | 15th 00:00 UTC | Mode 6+9+13e+12e+11a comprehensive maintenance | ~60 min |
Monthly GitHub Actions usage: ~350 minutes (well within free tier of 2,000 minutes).
Collection Pipeline
auto_collect_upload.py v7.0.3 (6,292 lines) supports 14+ modes:
| Mode | Function | Frequency |
|---|---|---|
| Mode 1 | SFC latest updates (6 official endpoints + HKMA) | Daily (auto) |
| Mode 2 | Historical deep scan (1m/3m/6m/1y) | Quarterly |
| Mode 3 | Local PDF import | On-demand |
| Mode 4 | Practical experience import (16 templates) | Ongoing |
| Mode 5 | Foundational documents import + health check | Monthly |
| Mode 6 | Industry intelligence scan (17 sources) | Monthly (auto) |
| Mode 7 | Universal file importer (PDF/DOCX/XLSX/TXT/MD) | On-demand |
| Mode 8 | Database management | Monthly |
| Mode 9 | Knowledge base update | Monthly (auto) |
| Mode 11 | Evaluation benchmark (50 questions) | Monthly (auto) |
| Mode 12 | Structured data extraction โ 4 tables | Monthly (auto) |
| Mode 13 | Data quality engine โ full scan + repair | Weekly (auto) |
| Mode 14 | Self-correction engine โ conflict detection + inspection | Daily/Weekly (auto) |
Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MCP Clients โ
โ Claude ยท ChatGPT ยท Cursor ยท VS Code โ
โ Claude Code ยท Any MCP Client โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MCP Protocol (Streamable HTTP)
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ VIGO MCP Server v2.1 (6 tools, 582 lines) โ
โ Supabase Edge Function (Deno TypeScript) โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโ
โผ โผ โผ
OpenAI Supabase DeepSeek + GPT-4o-mini
Embeddings PostgreSQL Dual-Model Routing
(1536-dim) pgvector (with auto-fallback)
+ BM25 FTS
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ vigo-chat v5.2 (1,032 lines) โ
โ Query Router (9 types) โ Hybrid Retrieval โ
โ โ RRF Fusion โ Score Fusion โ Diversity โ
โ โ Dual-Model โ Engram Memory โ Response โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ vigo-ingest v6.1.2 (458 lines) โ
โ Auto-classify โ Semantic chunk โ Verify โ
โ โ Grade (GOLD/SILVER/BRONZE) โ Store โ
โ โ Auto-generate quick questions โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Autonomous Operations โ
โ pg_cron (4 tasks) + GitHub Actions (3) โ
โ auto_collect_upload.py v7.0.3 (6,292 lines)โ
โ 14+ modes ยท Fully autonomous ยท Zero manual โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Edge Functions
| Function | Version | Lines | Purpose |
|---|---|---|---|
vigo-chat | v5.2 | 1,032 | Main API: query โ embedding โ hybrid retrieval โ dual-model routing โ answer |
vigo-mcp | v2.1 | 582 | MCP server: 6 tools, Streamable HTTP, authority-weighted post-processing |
vigo-ingest | v6.1.2 | 458 | Intelligent ingest: filter โ classify โ deduplicate โ verify โ extract |
vigo-quick-questions | v1.0 | 143 | Personalised follow-up question recommendations via Engram |
Database
| Table | Purpose |
|---|---|
vigo_knowledge | 6,381 knowledge chunks with embeddings (vector 1536), authority scores, verification grades |
vigo_enforcement | 28 structured enforcement records |
vigo_regulations | 21 structured regulation documents |
vigo_fee_benchmarks | 25 fee benchmark records |
vigo_license_market | 2 license market pricing records |
vigo_conversation_memory | Engram: conversation history with semantic vectors |
vigo_user_preferences | Engram: user language and interest preferences |
vigo_learning_progress | Engram: topic understanding levels |
Transport: Streamable HTTP (MCP standard)
Authentication: None required
Runtime: Supabase Edge Functions (Deno TypeScript)
Note: The MCP server is the open, stateless interface for any AI client. On the OrphicOne platform, VIGO also integrates Engram โ a long-term memory system that stores conversation history, tracks user preferences, and adapts responses based on learning progress. Engram uses semantic retrieval (vector similarity) over past dialogues to deliver increasingly personalised compliance guidance over time.
Distribution
| Channel | Status | Notes |
|---|---|---|
| MCP Official Registry | โ Active | Core channel, auto-synced by downstream platforms |
| Smithery | โ Published | All 6 tools recognised |
| Glama | โ Listed | Connector verification passed |
| Anthropic Connectors | โ Live | Highest traffic channel |
| PulseMCP | โณ Auto-syncing | Pulls from Registry |
.well-known | โ Configured | Supports auto-discovery |
Version History
| Version | Date | Highlights |
|---|---|---|
| v7.0 | 2026-02-24 | Sprint 1-4 (structured extraction + quality engine + self-correction + evaluation benchmarks), autonomous ops (pg_cron + GitHub Actions), dual-model routing, 6,292 lines |
| v6.0 | 2026-02-23 | Six-layer intelligent retrieval, three-tier verification, hybrid search, vigo-ingest, reference engine, 4,547 lines |
| v5.1 | 2026-02-21 | AI RO reasoning framework, compliance_check, risk_assessment, MCP tools 4โ6 |
| v5.0 | 2026-02-20 | Quality assurance framework, three-layer dedup, six-point validation, 35 foundational docs |
| v3.2 | 2026-02-03 | Architecture upgrade: DeepSeek/OpenAI direct connection, 50%+ latency reduction |
| v3.0 | 2026-02-03 | Anti-hallucination System Prompt + reranking filter |
| v2.0 | 2026-01-31 | Engram memory system full integration |
| v1.0 | 2026-01-29 | Initial release: basic RAG functionality |
About
OrphicOne is a Hong Kong-based regulatory intelligence platform for financial services.
VIGO is OrphicOne's AI-powered regulatory intelligence agent โ the industry's first and currently only MCP server dedicated to financial regulatory intelligence in any jurisdiction.
Positioning
Among 16,000+ MCP servers globally, VIGO occupies a unique position:
Global MCP Ecosystem (16,000+ servers)
โโโ Developer Tools โโโโโโโโโโโโโโโโ thousands
โโโ Productivity โโโโโโโโโโ hundreds
โโโ Data & Analytics โโโโโโโโ hundreds
โโโ Financial Reg Intelligence โ VIGO (only one)
โโโ HK SFC Reg Intelligence โ VIGO (industry first)
Data Moat
- 26 years of SFC regulatory history (2000โ2026)
- 6,381 verified knowledge chunks with three-tier quality grading
- 76 structured records across 4 specialised tables (enforcement, regulations, fees, market)
- 35 foundational documents + 5 thematic inspection reports
- 17 industry sources crawled monthly with sub-page extraction
- HKMA joint circulars + HKEX listing rules cross-referenced
- Three-layer deduplication + six-point content validation
- v7.0 intelligent engine with dual-model routing, self-correction, and autonomous operations
- World-Class benchmarks: Recall@5 80%, MRR 0.800, duplication 1.0%, GOLD rate 64.8%
- Knowledge that took years of domain expertise to curate โ not easily replicated
Philosophy
VIGO is built on the belief that compliance is not a cost โ it is a competitive advantage. Great compliance doesn't slow business down; it provides the foundation for sustainable growth, client trust, and market credibility.
Compliance is the floor (The Floor), ensuring safety. Business is the ceiling (The Ceiling), achieving breakthroughs. Grounded in compliance, fluent in capital. Compliance as shield, business as spear.
Roadmap
| Phase | Focus | Status |
|---|---|---|
| Phase 1 | SFC compliance โ all license types, enforcement, VATP, v7 engine, 35 foundational docs, 5 thematic reports, 17 industry sources, QA framework, autonomous ops, dual-model routing, structured data extraction | โ Live (v7.0) |
| Phase 2 | Full HK regulatory coverage (HKMA, IA, MPFA) | Planned (2026) |
| Phase 3 | Cross-border Asia-Pacific (Singapore MAS, Dubai VARA) | Future (2027) |
| Phase 4 | Global digital asset regulatory intelligence | Vision (2028+) |
Privacy
VIGO is a read-only regulatory intelligence service. We do not collect personal information, store conversation data, or require authentication. All query tools are marked readOnlyHint: true. See our Privacy Policy.
VIGO provides regulatory information query services only and does not constitute legal or financial advice. Users should treat VIGO's answers as reference and consult professional compliance advisors or lawyers when necessary.
Support
- Email: contact@orphicone.com
- Issues: GitHub Issues
- Website: orphicone.com
License
MIT
