cuthongthai-vn avatar

Vimo Stock Intelligence

cuthongthai-vn/vimo-mcp-server

Connects Claude to Vietnam's stock market with 35 tools spanning price discovery, technical analysis, and investment playbooks. Pulls real-time quotes via SSI FastConnect, scans 2,000+ Vietnamese stocks with 13 built-in screeners (growth, value, dividend), and surfaces foreign flow, whale activity, and insider transactions. The L8 playbooks layer is notable: you get pre-built strategies for commodity impacts, interest rate scenarios, sector rotation, and geopolitical risk (WarWatch OSINT). Requires a VIMO API key (demo key works for VN30 stocks). If you're trading Vietnamese equities or building market analysis workflows, this gives you fundamental data, technical signals, and macro context in one integration.

tools
34
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 21, 2026

Tools

34 tools

Public tool metadata for what this MCP can expose to an agent.

search_stocksSearch Vietnamese stocks by name or ticker

Search Vietnamese stocks by name or ticker

No parameter schema in public metadata yet.

get_stock_infoCompany profile + latest price + key financial ratios + moat score

Company profile + latest price + key financial ratios + moat score

No parameter schema in public metadata yet.

get_realtime_quoteReal-time price from SSI FastConnect + foreign flow + optional 1-min bars

Real-time price from SSI FastConnect + foreign flow + optional 1-min bars

No parameter schema in public metadata yet.

get_index_historyVNINDEX/VN30/HNX30 daily OHLCV history

VNINDEX/VN30/HNX30 daily OHLCV history

No parameter schema in public metadata yet.

get_macro_snapshotVietnam + global macro indicators (SBV rates, CPI, GDP, PMI)

Vietnam + global macro indicators (SBV rates, CPI, GDP, PMI)

No parameter schema in public metadata yet.

get_foreign_flowForeign investor net buy/sell — top 10 stocks

Foreign investor net buy/sell — top 10 stocks

No parameter schema in public metadata yet.

get_sector_rotationSector heatmap — hot/cold sectors by daily return

Sector heatmap — hot/cold sectors by daily return

No parameter schema in public metadata yet.

get_warwatch_osintWarWatch geopolitical risk score + Iran-Hormuz oil risk

WarWatch geopolitical risk score + Iran-Hormuz oil risk

No parameter schema in public metadata yet.

screen_stocksStock screener — 13 built-in strategies (growth, value, dividend, etc.)

Stock screener — 13 built-in strategies (growth, value, dividend, etc.)

No parameter schema in public metadata yet.

get_price_historyDaily OHLCV price history for any stock

Daily OHLCV price history for any stock

No parameter schema in public metadata yet.

get_financialsBalance sheet, income statement, cash flow, ratios

Balance sheet, income statement, cash flow, ratios

No parameter schema in public metadata yet.

get_technical_signalsTechnical indicators: RSI, MACD, MA cross, volume

Technical indicators: RSI, MACD, MA cross, volume

No parameter schema in public metadata yet.

get_ta_narrativeTechnical analysis + AI narrative for VN stocks

Technical analysis + AI narrative for VN stocks

No parameter schema in public metadata yet.

get_bctc_summaryFinancial statement analysis (ROE, Z-score, 5 strategies)

Financial statement analysis (ROE, Z-score, 5 strategies)

No parameter schema in public metadata yet.

get_factor_importanceFactor importance breakdown per stock

Factor importance breakdown per stock

No parameter schema in public metadata yet.

get_opinionAnalyst consensus + AI recommendation

Analyst consensus + AI recommendation

No parameter schema in public metadata yet.

get_insider_activityInsider trading transactions

Insider trading transactions

No parameter schema in public metadata yet.

get_corporate_eventsDividends, shareholder meetings, rights issues

Dividends, shareholder meetings, rights issues

No parameter schema in public metadata yet.

get_whale_activityUnusual volume stocks (>2× avg) — institutional signals

Unusual volume stocks (>2× avg) — institutional signals

No parameter schema in public metadata yet.

get_ai_performanceAI pick win rate and performance metrics

AI pick win rate and performance metrics

No parameter schema in public metadata yet.

get_news_sentimentNews sentiment score per stock — bullish/bearish/neutral

News sentiment score per stock — bullish/bearish/neutral

No parameter schema in public metadata yet.

get_bank_rate_playbooksInterest rate scenario strategies

Interest rate scenario strategies

No parameter schema in public metadata yet.

get_bds_playbooksReal estate investment playbooks

Real estate investment playbooks

No parameter schema in public metadata yet.

get_commodity_playbooksCommodity impact analysis

Commodity impact analysis

No parameter schema in public metadata yet.

get_dong_tien_playbooksMoney flow (foreign, institutional, retail)

Money flow (foreign, institutional, retail)

No parameter schema in public metadata yet.

get_fund_playbooksETF and mutual fund comparison

ETF and mutual fund comparison

No parameter schema in public metadata yet.

get_gia_toc_playbooksBusiness dynasty analysis

Business dynasty analysis

No parameter schema in public metadata yet.

get_investment_checklistsPre-investment due diligence

Pre-investment due diligence

No parameter schema in public metadata yet.

get_macro_playbooksMacroeconomic scenario strategies

Macroeconomic scenario strategies

No parameter schema in public metadata yet.

get_political_playbooksPolitical alpha (policy impact)

Political alpha (policy impact)

No parameter schema in public metadata yet.

get_psychology_playbooksTrading psychology

Trading psychology

No parameter schema in public metadata yet.

get_sector_rotation_playbooksSector rotation by market cycle

Sector rotation by market cycle

No parameter schema in public metadata yet.

get_warwatch_playbooksGeopolitical risk strategies

Geopolitical risk strategies

No parameter schema in public metadata yet.

get_wealth_playbooksPersonal wealth building

Personal wealth building

No parameter schema in public metadata yet.

Sponsors

Configuration

VIMO_API_KEY*secret

Your VIMO API key. Get one free at https://vimo.cuthongthai.vn/finance/ai/api-docs

Readme

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:


View the full README on GitHub

Details

Repository
github.com/cuthongthai-vn/vimo-mcp-server
Package
@vimo.cuthongthai.vn/mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active