cuthongthai-vn/vimo-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:
**Claude Code:**
**Cursor:** Add to ~/.cursor/mcp.json:
**Windsurf / Cline:** Add to MCP settings:
3. Ask Claude about Vietnamese stocks
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 | Interest rate scenario strategies |
| get_bds_playbooks | Real estate investment playbooks |
| get_commodity_playbooks | Commodity impact analysis |
| get_dong_tien_playbooks | Money flow (foreign, institutional, retail) |
| get_fund_playbooks | ETF and mutual fund comparison |
| get_gia_toc_playbooks | Business dynasty analysis |
| get_investment_checklists | Pre-investment due diligence |