Skip to main content
Glama

VIMO Financial Intelligence — MCP Server

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

npm License: MIT

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?"

Related MCP server: VNStock Agent MCP Server

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

get_macro_playbooks

Macroeconomic scenario strategies

get_political_playbooks

Political alpha (policy impact)

get_psychology_playbooks

Trading psychology

get_sector_rotation_playbooks

Sector rotation by market cycle

get_warwatch_playbooks

Geopolitical risk strategies

get_wealth_playbooks

Personal 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

Tier

Calls/day

Calls/min

Price

Demo

50

3

Free

Free

100

5

$0/mo

Developer

1,000

10

$19/mo

Pro

3,000

20

$49/mo

Enterprise

Unlimited

60

$299/mo

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

Environment Variables

Variable

Required

Default

Description

VIMO_API_KEY

Yes

—

Your VIMO API key

VIMO_API_BASE

No

https://vimo.cuthongthai.vn

API 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

Available Tools

35 tools
get_ai_performanceA
Read-onlyIdempotent

Get AI stock pick performance metrics — win rate, average return, Sharpe ratio. Forward-test data (not backtest). Hiệu suất AI chọn cổ phiếu — tỷ lệ thắng, lợi nhuận trung bình.

Inputs: no named parameters.

get_ai_performance_reportsB
Read-onlyIdempotent

Get detailed monthly AI performance reports with per-stock breakdown. Báo cáo hiệu suất AI picks hàng tháng chi tiết.

Inputs: month.

get_bank_rate_playbooksA
Read-onlyIdempotent

Investment playbooks based on bank interest rate scenarios in Vietnam. Chiến lược đầu tư theo kịch bản lãi suất.

Inputs: category, limit.

get_bctc_summaryA
Read-onlyIdempotent

Get financial statement (BCTC) analysis for a Vietnamese stock. Includes ROE, ROA, debt ratios, Altman Z-score. Supports 5 strategies: Buffett, Graham, Lynch, O'Neil, Piotroski. Phân tích báo cáo tài chính cổ phiếu Việt Nam.

Inputs: symbol (required).

get_bds_playbooksA
Read-onlyIdempotent

Real estate investment playbooks for Vietnam — pricing, location, financing. Chiến lược đầu tư bất động sản.

Inputs: category, limit.

get_commodity_playbooksA
Read-onlyIdempotent

Commodity investment playbooks — oil, gold, agricultural impact on VN market. Chiến lược hàng hoá.

Inputs: category, limit.

get_corporate_eventsA
Read-onlyIdempotent

Corporate events: personnel changes, shareholder meetings (ĐHCĐ), dividends. Sự kiện doanh nghiệp: nhân sự, ĐHCĐ.

Inputs: symbol, type.

get_dong_tien_playbooksB
Read-onlyIdempotent

Money flow analysis — foreign flow, institutional, retail patterns. Phân tích dòng tiền.

Inputs: category, limit.

get_factor_importanceA
Read-onlyIdempotent

Get factor importance breakdown for a stock — shows which data factors (technical, fundamental, macro, sentiment, etc.) most influenced the AI pick decision. Phân tích tầm quan trọng của từng yếu tố ảnh hưởng đến quyết định AI.

Inputs: symbol (required).

get_financialsA
Read-onlyIdempotent

Annual financial ratios: ROE, ROA, margins, P/E, P/B for a Vietnamese stock. Chỉ số tài chính hàng năm.

Inputs: symbol (required).

get_foreign_flowA
Read-onlyIdempotent

Foreign investor net buy/sell flow for Vietnamese stock market (HOSE). Includes top 10 net-buy and net-sell stocks by foreign investors, total buy/sell value, and foreign % of market volume. Dòng tiền khối ngoại mua/bán ròng.

Inputs: no named parameters.

get_fund_playbooksA
Read-onlyIdempotent

Investment fund comparison — ETFs, mutual funds, DCDS. So sánh quỹ đầu tư.

Inputs: category, limit.

get_gia_toc_playbooksB
Read-onlyIdempotent

Vietnam business dynasty analysis — family-owned conglomerate insights. Phân tích gia tộc kinh doanh.

Inputs: category, limit.

get_index_historyA
Read-onlyIdempotent

VNINDEX/VN30/HNX historical closing prices + market breadth. Lịch sử chỉ số VNINDEX/VN30/HNX.

Inputs: index, days.

get_insider_activityB
Read-onlyIdempotent

Insider trading transactions — buy/sell by executives and major shareholders. Giao dịch nội bộ cổ đông lớn.

Inputs: symbol (required), days.

get_investment_checklistsB
Read-onlyIdempotent

Pre-investment due diligence checklists for Vietnamese stocks. Danh sách kiểm tra đầu tư.

Inputs: category, limit.

get_macro_playbooksA
Read-onlyIdempotent

Macroeconomic scenario playbooks — GDP, CPI, FDI impact on stocks. Chiến lược vĩ mô.

Inputs: category, limit.

get_macro_snapshotA
Read-onlyIdempotent

Vietnam + US + China macro indicators: GDP, CPI, interest rates, FX, gold, oil. Chỉ số vĩ mô Việt Nam, Mỹ, Trung Quốc.

Inputs: category.

get_market_snapshotA
Read-onlyIdempotent

Complete daily market intelligence snapshot — combines all 13 data collectors: market, macro, sentiment, risk, commodity, top stocks, insider, moat, foreign flow, whale, sector rotation, ETF, dividend. Single call for comprehensive overview. Bức tranh toàn cảnh thị trường.

Inputs: no named parameters.

get_news_sentimentA
Read-onlyIdempotent

Daily news sentiment scores per ticker — bullish/bearish/neutral %, top events. AI-powered from Perplexity. Sentiment tin tức hàng ngày.

Inputs: symbol, days.

get_opinionB
Read-onlyIdempotent

AI-synthesized opinion: moat score + ESG score + insider signal + analyst consensus for a stock. Ý kiến tổng hợp AI: moat, ESG, nội bộ, chuyên gia.

Inputs: symbol (required).

get_political_playbooksA
Read-onlyIdempotent

Political alpha — policy events, government personnel changes impact. Alpha chính trị.

Inputs: category, limit.

get_price_historyB
Read-onlyIdempotent

OHLCV price history for individual Vietnamese stocks. Lịch sử giá OHLCV cổ phiếu.

Inputs: symbol (required), days.

get_psychology_playbooksB
Read-onlyIdempotent

Trading psychology — behavioral finance, fear/greed management. Tâm lý giao dịch.

Inputs: category, limit.

get_realtime_quoteA
Read-onlyIdempotent

Latest stock price from SSI FastConnect — real-time during market hours (15min delay). Includes foreign buy/sell flow and optional 1-min intraday OHLC bars. Giá cổ phiếu real-time từ SSI.

Inputs: symbol (required), intraday.

get_sector_rotationA
Read-onlyIdempotent

Sector rotation heatmap — average daily return, total volume, and stock count per industry group. Identifies hottest and coldest sectors. Luân chuyển dòng tiền giữa các ngành.

Inputs: no named parameters.

get_sector_rotation_playbooksB
Read-onlyIdempotent

Sector rotation by market cycle — identify outperforming VN sectors. Luân chuyển ngành.

Inputs: category, limit.

get_stock_infoA
Read-onlyIdempotent

Company profile + latest price + key financial ratios + moat score — all in 1 call. Thông tin tổng quan cổ phiếu: giá, tài chính, moat.

Inputs: symbol (required).

get_ta_narrativeA
Read-onlyIdempotent

Get technical analysis signals and AI-generated narrative for a Vietnamese stock. Returns RSI, MACD, moving averages, buy/sell votes, and market commentary. Lấy tín hiệu phân tích kỹ thuật và bình luận AI cho cổ phiếu Việt Nam.

Inputs: symbol (required).

get_technical_signalsB
Read-onlyIdempotent

Technical analysis signals: RSI, MACD, Bollinger Bands, buy/sell votes, confidence score. Tín hiệu kỹ thuật MUA/BÁN.

Inputs: symbol (required), days.

get_warwatch_playbooksB
Read-onlyIdempotent

Geopolitical risk playbooks — war impact, oil price, defense stocks. Chiến lược địa chính trị.

Inputs: category, limit.

get_wealth_playbooksB
Read-onlyIdempotent

Personal wealth building — savings, allocation by age/risk. Xây dựng tài sản cá nhân.

Inputs: category, limit.

get_whale_activityA
Read-onlyIdempotent

Whale/institutional activity detector — stocks with abnormal trading volume (>2× 20-day average). Sorted by volume ratio. Phát hiện cổ phiếu có khối lượng bất thường (cá mập giao dịch).

Inputs: no named parameters.

screen_stocksB
Read-onlyIdempotent

Multi-strategy stock screening (13 strategies: Buffett, Graham, Piotroski, Lynch, O'Neil...). Sàng lọc cổ phiếu theo 13 chiến lược đầu tư.

Inputs: strategy, min_score.

search_stocksC
Read-onlyIdempotent

Search Vietnamese stocks by ticker or company name. Filter by sector (VN30, Banking, Tech). Tìm cổ phiếu theo mã hoặc tên.

Inputs: q (required), sector, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 35 tools

    Disambiguation4/5

    Most tools have clear, distinct purposes, e.g., get_ai_performance vs get_ai_performance_reports. However, some overlap exists: get_financials and get_bctc_summary both provide financial ratios, and get_ta_narrative includes technical signals overlapping with get_technical_signals. Playbook tools are numerous but differentiated by domain.

    Naming Consistency4/5

    The vast majority follow a consistent 'get_<noun>' pattern (e.g., get_ai_performance, get_market_snapshot). Two tools, screen_stocks and search_stocks, break the pattern by using verbs without 'get', but they are clearly distinct actions. No mixing of naming conventions (camelCase, snake_case) is observed.

    Tool Count3/5

    At 35 tools, the server is on the high end of the acceptable range. The domain (Vietnamese stock market intelligence) is broad, justifying many tools, but it feels slightly overloaded with 13 playbook tools that could potentially be consolidated. Still, it remains navigable.

    Completeness4/5

    The tool set covers a wide range of investment data: performance, financial statements, technical signals, sentiment, macro, insider trading, foreign flow, sector rotation, screening, and playbooks for various scenarios. Minor gaps may exist (e.g., explicit dividend data, portfolio management actions), but the surface is largely complete for a read-only data server.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Unofficial MCP server providing Vietnamese stock market financial data, enabling natural language interaction with Claude Desktop.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides Vietnamese financial market data through Claude Desktop, including historical prices, portfolio optimization, financial statements, and fund management.
      -