{
  "markdown": "# VIMO Financial Intelligence — MCP Server\n\n> 🦉 Vietnam's most comprehensive financial data and AI analysis platform, accessible via the Model Context Protocol.\n\n[![npm](https://img.shields.io/npm/v/@vimo.cuthongthai.vn/mcp-server)](https://www.npmjs.com/package/@vimo.cuthongthai.vn/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### 1. Get your API key (free)\n\nVisit [vimo.cuthongthai.vn/finance/ai/api-docs](https://vimo.cuthongthai.vn/finance/ai/api-docs) → Create key → Copy.\n\nOr use the demo key: `vimo_demo_public_readonly_2026` (rate-limited, VN30 only)\n\n### 2. Connect to Claude Desktop\n\nAdd to `~/.claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vimo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@vimo.cuthongthai.vn/mcp-server\"],\n      \"env\": {\n        \"VIMO_API_KEY\": \"vimo_demo_public_readonly_2026\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude config add-mcp vimo-financial-intel -- env VIMO_API_KEY=vimo_demo_public_readonly_2026 npx -y @vimo.cuthongthai.vn/mcp-server\n```\n\n**Cursor:** Add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vimo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@vimo.cuthongthai.vn/mcp-server\"],\n      \"env\": {\n        \"VIMO_API_KEY\": \"vimo_demo_public_readonly_2026\"\n      }\n    }\n  }\n}\n```\n\n**Windsurf / Cline:** Add to MCP settings:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@vimo.cuthongthai.vn/mcp-server\"],\n  \"env\": { \"VIMO_API_KEY\": \"vimo_demo_public_readonly_2026\" }\n}\n```\n\n### 3. Ask Claude about Vietnamese stocks\n\n```\n\"FPT giá bao nhiêu hôm nay?\"\n\"Phân tích kỹ thuật VCB\"\n\"Sàng lọc cổ phiếu tăng trưởng\"\n\"AI pick win rate tháng này?\"\n\"Best commodity playbook for rising oil?\"\n```\n\n## Available Tools (35)\n\n### L0: DISCOVER (3)\n| Tool | Description |\n|------|-------------|\n| `search_stocks` | Search Vietnamese stocks by name or ticker |\n| `get_stock_info` | Company profile + latest price + key financial ratios + moat score |\n| `get_realtime_quote` | Real-time price from SSI FastConnect + foreign flow + optional 1-min bars |\n\n### L1: CONTEXT (5)\n| Tool | Description |\n|------|-------------|\n| `get_index_history` | VNINDEX/VN30/HNX30 daily OHLCV history |\n| `get_macro_snapshot` | Vietnam + global macro indicators (SBV rates, CPI, GDP, PMI) |\n| `get_foreign_flow` | Foreign investor net buy/sell — top 10 stocks |\n| `get_sector_rotation` | Sector heatmap — hot/cold sectors by daily return |\n| `get_warwatch_osint` | WarWatch geopolitical risk score + Iran-Hormuz oil risk |\n\n### L2: SCREEN (2)\n| Tool | Description |\n|------|-------------|\n| `screen_stocks` | Stock screener — 13 built-in strategies (growth, value, dividend, etc.) |\n| `get_sector_rotation` | Sector heatmap for rotation timing |\n\n### L3: ANALYZE (6)\n| Tool | Description |\n|------|-------------|\n| `get_price_history` | Daily OHLCV price history for any stock |\n| `get_financials` | Balance sheet, income statement, cash flow, ratios |\n| `get_technical_signals` | Technical indicators: RSI, MACD, MA cross, volume |\n| `get_ta_narrative` | Technical analysis + AI narrative for VN stocks |\n| `get_bctc_summary` | Financial statement analysis (ROE, Z-score, 5 strategies) |\n| `get_factor_importance` | Factor importance breakdown per stock |\n\n### L4: VALIDATE (5)\n| Tool | Description |\n|------|-------------|\n| `get_opinion` | Analyst consensus + AI recommendation |\n| `get_insider_activity` | Insider trading transactions |\n| `get_corporate_events` | Dividends, shareholder meetings, rights issues |\n| `get_whale_activity` | Unusual volume stocks (>2× avg) — institutional signals |\n| `get_ai_performance` | AI pick win rate and performance metrics |\n\n### L5: DECIDE (1)\n| Tool | Description |\n|------|-------------|\n| `get_news_sentiment` | News sentiment score per stock — bullish/bearish/neutral |\n\n### L8: LEARN — Investment Playbooks (13)\n| Tool | Description |\n|------|-------------|\n| `get_bank_rate_playbooks` | Interest rate scenario strategies |\n| `get_bds_playbooks` | Real estate investment playbooks |\n| `get_commodity_playbooks` | Commodity impact analysis |\n| `get_dong_tien_playbooks` | Money flow (foreign, institutional, retail) |\n| `get_fund_playbooks` | ETF and mutual fund comparison |\n| `get_gia_toc_playbooks` | Business dynasty analysis |\n| `get_investment_checklists` | Pre-investment due diligence |\n| `get_macro_playbooks` | Macroeconomic scenario strategies |\n| `get_political_playbooks` | Political alpha (policy impact) |\n| `get_psychology_playbooks` | Trading psychology |\n| `get_sector_rotation_playbooks` | Sector rotation by market cycle |\n| `get_warwatch_playbooks` | Geopolitical risk strategies |\n| `get_wealth_playbooks` | Personal wealth building |\n\n## Security\n\n- 🔒 **API key required** — server refuses to start without valid `VIMO_API_KEY`\n- 🔑 **Key format validation** — must match `vimo_[a-zA-Z0-9]{32+}` or `vimo_demo*`\n- ⏱️ **30s request timeout** — prevents hanging connections\n- 🛡️ **12-layer defense** on server side (rate limiting, input sanitization, canary detection)\n- 🧹 **Input sanitized** — symbols and categories validated before sending\n\n## Data Coverage\n\n- **~2,000 VN stocks** (HOSE, HNX, UPCOM)\n- **50+ data sources** (SBV, GSO, SSI FastConnect, FMP, Yahoo, Binance)\n- **Real-time prices** via SSI FastConnect (15-min delay during market hours)\n- **Daily updates** (6:00 AM ICT) for fundamentals, signals, and AI picks\n\n## Rate Limits\n\n| Tier | Calls/day | Calls/min | Price |\n|------|-----------|-----------|-------|\n| Demo | 50 | 3 | Free |\n| Free | 100 | 5 | $0/mo |\n| Developer | 1,000 | 10 | $19/mo |\n| Pro | 3,000 | 20 | $49/mo |\n| Enterprise | Unlimited | 60 | $299/mo |\n\nGet your API key at [vimo.cuthongthai.vn/finance/ai/api-docs](https://vimo.cuthongthai.vn/finance/ai/api-docs)\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|:--------:|---------|-------------|\n| `VIMO_API_KEY` | **Yes** | — | Your VIMO API key |\n| `VIMO_API_BASE` | No | `https://vimo.cuthongthai.vn` | API base URL |\n\n## Also Available\n\n- **REST API**: `GET https://vimo.cuthongthai.vn/api/mcp/realtime-quote?symbol=FPT` (+ `x-api-key` header)\n- **MCP manifest**: `https://vimo.cuthongthai.vn/api/mcp/manifest.json` (35 tools)\n- **Discovery**: `/.well-known/mcp.json`, `/llms.txt`\n- **LLM info**: `https://vimo.cuthongthai.vn/llms.txt`\n\n## License\n\nMIT — © CuThongThai 2026\n",
  "bytes": 6441,
  "sha": "d9dfc66a148592524136cd6327f899ef50956a2298df424a46bc167cc41fbb26",
  "repo_slug": "cuthongthai-vn/vimo-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cuthongthai_vn_vimo_stock_inte_64fd1ce0/readme"
}