English Français العربية

io.github.cuthongthai-vn/vimo-stock-intelligence

السجل الرسمي المالية والمدفوعات

Vietnam stock MCP: TA signals, Z/F/M scores, foreign flow, whale detection. 2000+ VN stocks.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @vimo.cuthongthai.vn/mcp-server
Claude Code 
claude mcp add vimo-stock-intelligence -e 'VIMO_API_KEY=<your vimo_api_key>' -- npx -y @vimo.cuthongthai.vn/mcp-server@1.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vimo-stock-intelligence": {
            "command": "npx",
            "args": [
                "-y",
                "@vimo.cuthongthai.vn/mcp-server@1.2.0"
            ],
            "env": {
                "VIMO_API_KEY": "<your vimo_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • VIMO_API_KEY إلزامي سري Your VIMO API key. Get one free at https://vimo.cuthongthai.vn/finance/ai/api-docs

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. VIMO Financial Intelligence — MCP Server
  2. Quick Start
  3. Available Tools (35)
  4. Security
  5. Data Coverage
  6. Rate Limits
  7. Environment Variables
  8. Also Available
  9. License

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)
ToolDescription
search_stocksSearch Vietnamese stocks by name or ticker
get_stock_infoCompany profile + latest price + key financial ratios + moat score
get_realtime_quoteReal-time price from SSI FastConnect + foreign flow + optional 1-min bars
L1: CONTEXT (5)
ToolDescription
get_index_historyVNINDEX/VN30/HNX30 daily OHLCV history
get_macro_snapshotVietnam + global macro indicators (SBV rates, CPI, GDP, PMI)
get_foreign_flowForeign investor net buy/sell — top 10 stocks
get_sector_rotationSector heatmap — hot/cold sectors by daily return
get_warwatch_osintWarWatch geopolitical risk score + Iran-Hormuz oil risk
L2: SCREEN (2)
ToolDescription
screen_stocksStock screener — 13 built-in strategies (growth, value, dividend, etc.)
get_sector_rotationSector heatmap for rotation timing
L3: ANALYZE (6)
ToolDescription
get_price_historyDaily OHLCV price history for any stock
get_financialsBalance sheet, income statement, cash flow, ratios
get_technical_signalsTechnical indicators: RSI, MACD, MA cross, volume
get_ta_narrativeTechnical analysis + AI narrative for VN stocks
get_bctc_summaryFinancial statement analysis (ROE, Z-score, 5 strategies)
get_factor_importanceFactor importance breakdown per stock
L4: VALIDATE (5)
ToolDescription
get_opinionAnalyst consensus + AI recommendation
get_insider_activityInsider trading transactions
get_corporate_eventsDividends, shareholder meetings, rights issues
get_whale_activityUnusual volume stocks (>2× avg) — institutional signals
get_ai_performanceAI pick win rate and performance metrics
L5: DECIDE (1)
ToolDescription
get_news_sentimentNews sentiment score per stock — bullish/bearish/neutral
L8: LEARN — Investment Playbooks (13)
ToolDescription
get_bank_rate_playbooksInterest rate scenario strategies
get_bds_playbooksReal estate investment playbooks
get_commodity_playbooksCommodity impact analysis
get_dong_tien_playbooksMoney flow (foreign, institutional, retail)
get_fund_playbooksETF and mutual fund comparison
get_gia_toc_playbooksBusiness dynasty analysis
get_investment_checklistsPre-investment due diligence
get_macro_playbooksMacroeconomic scenario strategies
get_political_playbooksPolitical alpha (policy impact)
get_psychology_playbooksTrading psychology
get_sector_rotation_playbooksSector rotation by market cycle
get_warwatch_playbooksGeopolitical risk strategies
get_wealth_playbooksPersonal wealth building

Security

  • 🔒 API key required — server refuses to start without valid VIMO_API_KEY
  • 🔑 Key format validation — must match vimo_[a-zA-Z0-9]{32+} or vimo_demo*
  • ⏱️ 30s request timeout — prevents hanging connections
  • 🛡️ 12-layer defense on server side (rate limiting, input sanitization, canary detection)
  • 🧹 Input sanitized — symbols and categories validated before sending

Data Coverage

  • ~2,000 VN stocks (HOSE, HNX, UPCOM)
  • 50+ data sources (SBV, GSO, SSI FastConnect, FMP, Yahoo, Binance)
  • Real-time prices via SSI FastConnect (15-min delay during market hours)
  • Daily updates (6:00 AM ICT) for fundamentals, signals, and AI picks

Rate Limits

TierCalls/dayCalls/minPrice
Demo503Free
Free1005$0/mo
Developer1,00010$19/mo
Pro3,00020$49/mo
EnterpriseUnlimited60$299/mo

Get your API key at vimo.cuthongthai.vn/finance/ai/api-docs

Environment Variables

VariableRequiredDefaultDescription
VIMO_API_KEYYes—Your VIMO API key
VIMO_API_BASENohttps://vimo.cuthongthai.vnAPI base URL

Also Available

  • REST API: GET https://vimo.cuthongthai.vn/api/mcp/realtime-quote?symbol=FPT (+ x-api-key header)
  • MCP manifest: https://vimo.cuthongthai.vn/api/mcp/manifest.json (35 tools)
  • Discovery: /.well-known/mcp.json, /llms.txt
  • LLM info: https://vimo.cuthongthai.vn/llms.txt

License

MIT — © CuThongThai 2026

الأسئلة الشائعة

ما هو io.github.cuthongthai-vn/vimo-stock-intelligence؟

Vietnam stock MCP: TA signals, Z/F/M scores, foreign flow, whale detection. 2000+ VN stocks.

كيف أثبّت io.github.cuthongthai-vn/vimo-stock-intelligence؟

يعمل على جهازك. في Claude Code: claude mcp add vimo-stock-intelligence -e 'VIMO_API_KEY=<your vimo_api_key>' -- npx -y @vimo.cuthongthai.vn/mcp-server@1.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.cuthongthai-vn/vimo-stock-intelligence إلى مفتاح API؟

نعم. يتطلب VIMO_API_KEY، وتضبطها في إعداداته.

هل io.github.cuthongthai-vn/vimo-stock-intelligence مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.cuthongthai-vn/vimo-stock-intelligence؟

ينشره cuthongthai-vn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.