Vimo Stock Intelligence

io.github.cuthongthai-vnPublished by GitHub account cuthongthai-vnv1.2.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that gives an assistant Vietnamese stock-market data and analysis: quotes, technical signals, screening, foreign flow and investment playbook

What you can do
Search and profile Vietnamese stocks, with company data, key ratios and real-time quotes including foreign flow and optional minute bars. Pull market context: index history, macro indicators, foreign net buy/sell, sector rotation and a geopolitical risk score. Screen stocks with built-in strategies and analyze price history, financial statements, technical indicators and factor importance. Validate ideas with analyst consensus, insider activity, corporate events, unusual-volume detection and AI pick performance. Read news sentiment and a set of investment playbooks covering rates, real estate, commodities, money flow, funds, macro, politics, psychology and wealth building.
When to use it
Useful when you want an assistant to research or discuss Vietnamese equities (HOSE, HNX, UPCOM), screen for candidates, or walk through market context and strategy playbooks without leaving the chat.
Requirements
Runs locally via npx, so Node.js is needed, and it is configured in a desktop client such as Claude Desktop, Claude Code, Cursor, Windsurf or Cline. A VIMO API key is required in the VIMO_API_KEY environment variable; a free tier and a rate-limited demo key are offered. Network access to the VIMO API is needed, and an optional VIMO_API_BASE can override the endpoint.
Before you install
The API key is a secret passed in the environment; keep it out of shared configs and repositories. Paid tiers exist (Developer, Pro, Enterprise), and the free and demo tiers are rate-limited. Market data is informational, not investment advice, and real-time prices may be delayed during trading hours. Queries and symbols are sent to the VIMO service.

Installation

In SourceWeft

  1. Open Vimo Stock Intelligence in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

json
{  "mcpServers": {    "vimo": {      "command": "npx",      "args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],      "env": {        "VIMO_API_KEY": "vimo_demo_public_readonly_2026"      }    }  }}

Claude Code:

bash
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:

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:

json
{  "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

Source: README.md at commit da8944d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts