VNStock Agent MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VNSTOCK_SOURCE | No | Default data source (VCI, KBS) | VCI |
| VNSTOCK_API_KEY | Yes | VNStock API key, get one at https://vnstocks.com/login | |
| VNSTOCK_MCP_HOST | No | Server host | 0.0.0.0 |
| VNSTOCK_MCP_PORT | No | Server port | 8000 |
| VNSTOCK_MCP_TRANSPORT | No | MCP transport (stdio, sse, http) | stdio |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| stock_historyB | Get historical OHLCV price data for a Vietnamese stock. |
| stock_intradayB | Get intraday (today's) trading data for a stock. |
| stock_price_depthB | Get order book / price depth (bid/ask levels) for a stock. |
| company_overviewC | Get company overview information (industry, market cap, description, etc). |
| company_shareholdersC | Get major shareholders of a company. |
| company_officersC | Get company officers / management team. |
| company_newsB | Get latest news about a company. |
| company_eventsC | Get company events (dividends, AGM, earnings, etc). |
| financial_balance_sheetC | Get balance sheet data for a company. |
| financial_income_statementC | Get income statement data for a company. |
| financial_cash_flowC | Get cash flow statement for a company. |
| financial_ratioB | Get financial ratios (P/E, P/B, ROE, ROA, etc) for a company. |
| listing_all_symbolsA | Get all listed stock symbols on Vietnamese exchanges (HOSE, HNX, UPCOM). |
| listing_symbols_by_groupC | Get stock symbols in a market group. |
| listing_symbols_by_exchangeA | Get stock symbols grouped by exchange (HOSE, HNX, UPCOM). |
| listing_industriesC | Get ICB industry classification for Vietnamese stocks. |
| trading_price_boardB | Get real-time price board for multiple stocks. |
| fx_historyC | Get forex (currency pair) historical price data. |
| crypto_historyB | Get cryptocurrency historical price data. |
| world_index_historyC | Get world market index historical data. |
| fund_listingB | Get list of open-ended mutual funds available in Vietnam. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Most tools are clearly separated by domain (company, stock, financial, listing, etc.), but the three listing tools (all_symbols, by_group, by_exchange) overlap heavily and could cause misselection. Stock history, intraday, and price board also have related purposes, though descriptions help distinguish them.
All names use lowercase snake_case with a domain prefix, which is predictable. The pattern is not strictly verb_noun (some are noun_noun like 'company_events', some gerund-based like 'listing_all_symbols'), but within each domain the style is uniform and readable.
21 tools is slightly above the typical comfortable range, but the server covers a broad domain (Vietnamese equities, forex, crypto, world indices, funds) and each tool addresses a distinct data need. The count feels justified rather than bloated.
The toolset covers the core lifecycle of market data: company fundamentals, financial statements, price history, intraday data, depth, listings, and news. It also extends to other asset classes. Minor gaps like missing specific company dividend details (subsumed by events) or quote snapshot endpoint are workarounds.