vimo-mcp-server
The VIMO MCP server provides comprehensive Vietnamese stock market intelligence and AI-powered financial analysis through 35+ tools.
Stock Discovery & Quotes
Search Vietnamese stocks by ticker or company name (with optional sector filtering)
Get company profiles with latest price, financial ratios, and moat scores
Retrieve real-time quotes (15-min delay via SSI FastConnect) including foreign buy/sell flow and optional 1-minute intraday OHLC bars
Market & Macroeconomic Data
Historical OHLCV data for VNINDEX, VN30, and HNX indices
Daily market snapshot combining 13 data collectors in a single call
Sector rotation heatmaps (hot/cold sectors by daily return)
Vietnam, US, and China macro indicators (GDP, CPI, interest rates, FX, gold, oil)
Foreign investor net buy/sell flows with top 10 net-buy/sell stocks
Geopolitical risk scores (WarWatch, Iran-Hormuz oil risk)
Stock Screening
Screen stocks using 13 built-in strategies: Buffett, Graham, Piotroski, Lynch, O'Neil, CANSLIM, and more
Filter by minimum score thresholds
Technical & Fundamental Analysis
Technical signals: RSI, MACD, Bollinger Bands, moving averages, buy/sell votes
AI-generated technical analysis narratives
Annual financial ratios (ROE, ROA, margins, P/E, P/B) and full financial statements
Altman Z-score and multi-strategy evaluation
Factor importance showing which inputs most influenced AI decisions
Market Intelligence & Validation
AI-synthesized opinions combining moat score, ESG, insider signals, and analyst consensus
Insider trading transactions by executives and major shareholders
Corporate events: dividends, shareholder meetings, personnel changes
Unusual volume detection (>2× average) for institutional/whale activity
Daily news sentiment scores (bullish/bearish/neutral) per stock or market-wide
AI Performance Tracking
AI stock pick win rates, average returns, and Sharpe ratios (forward-test data)
Detailed monthly AI performance reports with per-stock breakdowns
Investment Playbooks (13 categories) Bank interest rate scenarios, real estate strategies, commodity impact (oil/gold/agriculture), money flow patterns, ETF/fund comparisons, Vietnam business dynasty insights, pre-investment due diligence, macroeconomic scenarios, political alpha, trading psychology, sector rotation by market cycle, geopolitical risk strategies, and personal wealth building frameworks.
Integrates Binance as one of over 50 data sources to provide cryptocurrency market data and price information for comprehensive financial analysis.
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-serverCursor: 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 Vietnamese stocks by name or ticker |
| Company profile + latest price + key financial ratios + moat score |
| Real-time price from SSI FastConnect + foreign flow + optional 1-min bars |
L1: CONTEXT (5)
Tool | Description |
| VNINDEX/VN30/HNX30 daily OHLCV history |
| Vietnam + global macro indicators (SBV rates, CPI, GDP, PMI) |
| Foreign investor net buy/sell — top 10 stocks |
| Sector heatmap — hot/cold sectors by daily return |
| WarWatch geopolitical risk score + Iran-Hormuz oil risk |
L2: SCREEN (2)
Tool | Description |
| Stock screener — 13 built-in strategies (growth, value, dividend, etc.) |
| Sector heatmap for rotation timing |
L3: ANALYZE (6)
Tool | Description |
| Daily OHLCV price history for any stock |
| Balance sheet, income statement, cash flow, ratios |
| Technical indicators: RSI, MACD, MA cross, volume |
| Technical analysis + AI narrative for VN stocks |
| Financial statement analysis (ROE, Z-score, 5 strategies) |
| Factor importance breakdown per stock |
L4: VALIDATE (5)
Tool | Description |
| Analyst consensus + AI recommendation |
| Insider trading transactions |
| Dividends, shareholder meetings, rights issues |
| Unusual volume stocks (>2× avg) — institutional signals |
| AI pick win rate and performance metrics |
L5: DECIDE (1)
Tool | Description |
| News sentiment score per stock — bullish/bearish/neutral |
L8: LEARN — Investment Playbooks (13)
Tool | Description |
| Interest rate scenario strategies |
| Real estate investment playbooks |
| Commodity impact analysis |
| Money flow (foreign, institutional, retail) |
| ETF and mutual fund comparison |
| Business dynasty analysis |
| Pre-investment due diligence |
| Macroeconomic scenario strategies |
| Political alpha (policy impact) |
| Trading psychology |
| Sector rotation by market cycle |
| Geopolitical risk strategies |
| 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+}orvimo_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 |
| Yes | — | Your VIMO API key |
| No |
| API base URL |
Also Available
REST API:
GET https://vimo.cuthongthai.vn/api/mcp/realtime-quote?symbol=FPT(+x-api-keyheader)MCP manifest:
https://vimo.cuthongthai.vn/api/mcp/manifest.json(35 tools)Discovery:
/.well-known/mcp.json,/llms.txtLLM info:
https://vimo.cuthongthai.vn/llms.txt
License
MIT — © CuThongThai 2026
Available Tools
35 toolsget_ai_performanceARead-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_reportsBRead-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_playbooksARead-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_summaryARead-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_playbooksARead-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_playbooksARead-onlyIdempotent
Commodity investment playbooks — oil, gold, agricultural impact on VN market. Chiến lược hàng hoá.
Inputs: category, limit.
get_corporate_eventsARead-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_playbooksBRead-onlyIdempotent
Money flow analysis — foreign flow, institutional, retail patterns. Phân tích dòng tiền.
Inputs: category, limit.
get_factor_importanceARead-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_financialsARead-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_flowARead-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_playbooksARead-onlyIdempotent
Investment fund comparison — ETFs, mutual funds, DCDS. So sánh quỹ đầu tư.
Inputs: category, limit.
get_gia_toc_playbooksBRead-onlyIdempotent
Vietnam business dynasty analysis — family-owned conglomerate insights. Phân tích gia tộc kinh doanh.
Inputs: category, limit.
get_index_historyARead-onlyIdempotent
VNINDEX/VN30/HNX historical closing prices + market breadth. Lịch sử chỉ số VNINDEX/VN30/HNX.
Inputs: index, days.
get_insider_activityBRead-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_checklistsBRead-onlyIdempotent
Pre-investment due diligence checklists for Vietnamese stocks. Danh sách kiểm tra đầu tư.
Inputs: category, limit.
get_macro_playbooksARead-onlyIdempotent
Macroeconomic scenario playbooks — GDP, CPI, FDI impact on stocks. Chiến lược vĩ mô.
Inputs: category, limit.
get_macro_snapshotARead-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_snapshotARead-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_sentimentARead-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_opinionBRead-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_playbooksARead-onlyIdempotent
Political alpha — policy events, government personnel changes impact. Alpha chính trị.
Inputs: category, limit.
get_price_historyBRead-onlyIdempotent
OHLCV price history for individual Vietnamese stocks. Lịch sử giá OHLCV cổ phiếu.
Inputs: symbol (required), days.
get_psychology_playbooksBRead-onlyIdempotent
Trading psychology — behavioral finance, fear/greed management. Tâm lý giao dịch.
Inputs: category, limit.
get_realtime_quoteARead-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_rotationARead-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_playbooksBRead-onlyIdempotent
Sector rotation by market cycle — identify outperforming VN sectors. Luân chuyển ngành.
Inputs: category, limit.
get_stock_infoARead-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_narrativeARead-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_signalsBRead-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_playbooksBRead-onlyIdempotent
Geopolitical risk playbooks — war impact, oil price, defense stocks. Chiến lược địa chính trị.
Inputs: category, limit.
get_wealth_playbooksBRead-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_activityARead-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_stocksBRead-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_stocksCRead-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
Scored across 35 tools
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.
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.
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.
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
Related MCP Connectors
Vietnam stock market data: HOSE/HNX/UPCOM prices, foreign flow, order book, financials, macro, news.
Vietnam stock market data for AI: prices, financials, broker research, macro, VN-Index forecast
MCP server for real-time China A-share stock quotes, indices and market data.
Vietnam stock market data & portfolios via Finhay Securities OpenAPI.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceUnofficial MCP server providing Vietnamese stock market financial data, enabling natural language interaction with Claude Desktop.MIT
- AlicenseBqualityDmaintenanceMCP server for Vietnamese stock market data, enabling AI assistants to access stock history, financials, company info, and global market data through 21 tools.21104MIT
- AlicenseBqualityDmaintenanceProvides tools to access Vietnam stock market data, including stock prices, financial statements, and market statistics.363MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides Vietnamese financial market data through Claude Desktop, including historical prices, portfolio optimization, financial statements, and fund management.-