VIMO Financial Intelligence — MCP Server

🦉 Vietnam's most comprehensive financial data and AI analysis platform, accessible via the Model Context Protocol.

Quick Start

1. Get your API key (free)

Visit vimo.cuthongthai.vn/finance/ai/api-docs → Create key → Copy.

Or use the demo key: vimo_demo_public_readonly_2026 (rate-limited, VN30 only)

2. Connect to Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vimo": {
      "command": "npx",
      "args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
      "env": {
        "VIMO_API_KEY": "vimo_demo_public_readonly_2026"
      }
    }
  }
}

Claude Code:

claude config add-mcp vimo-financial-intel -- env VIMO_API_KEY=vimo_demo_public_readonly_2026 npx -y @vimo.cuthongthai.vn/mcp-server

Cursor: Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vimo": {
      "command": "npx",
      "args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
      "env": {
        "VIMO_API_KEY": "vimo_demo_public_readonly_2026"
      }
    }
  }
}

Windsurf / Cline: Add to MCP settings:

{
  "command": "npx",
  "args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
  "env": { "VIMO_API_KEY": "vimo_demo_public_readonly_2026" }
}

3. Ask Claude about Vietnamese stocks

"FPT giá bao nhiêu hôm nay?"
"Phân tích kỹ thuật VCB"
"Sàng lọc cổ phiếu tăng trưởng"
"AI pick win rate tháng này?"
"Best commodity playbook for rising oil?"

Available Tools (35)

L0: DISCOVER (3)

Tool	Description
search_stocks	Search Vietnamese stocks by name or ticker
get_stock_info	Company profile + latest price + key financial ratios + moat score
get_realtime_quote	Real-time price from SSI FastConnect + foreign flow + optional 1-min bars

L1: CONTEXT (5)

Tool	Description
get_index_history	VNINDEX/VN30/HNX30 daily OHLCV history
get_macro_snapshot	Vietnam + global macro indicators (SBV rates, CPI, GDP, PMI)
get_foreign_flow	Foreign investor net buy/sell — top 10 stocks
get_sector_rotation	Sector heatmap — hot/cold sectors by daily return
get_warwatch_osint	WarWatch geopolitical risk score + Iran-Hormuz oil risk

L2: SCREEN (2)

Tool	Description
screen_stocks	Stock screener — 13 built-in strategies (growth, value, dividend, etc.)
get_sector_rotation	Sector heatmap for rotation timing

L3: ANALYZE (6)

Tool	Description
get_price_history	Daily OHLCV price history for any stock
get_financials	Balance sheet, income statement, cash flow, ratios
get_technical_signals	Technical indicators: RSI, MACD, MA cross, volume
get_ta_narrative	Technical analysis + AI narrative for VN stocks
get_bctc_summary	Financial statement analysis (ROE, Z-score, 5 strategies)
get_factor_importance	Factor importance breakdown per stock

L4: VALIDATE (5)

Tool	Description
get_opinion	Analyst consensus + AI recommendation
get_insider_activity	Insider trading transactions
get_corporate_events	Dividends, shareholder meetings, rights issues
get_whale_activity	Unusual volume stocks (>2× avg) — institutional signals
get_ai_performance	AI pick win rate and performance metrics

L5: DECIDE (1)

Tool	Description
get_news_sentiment	News sentiment score per stock — bullish/bearish/neutral

L8: LEARN — Investment Playbooks (13)

Tool	Description
get_bank_rate_playbooks

... View full README on GitHub