VNStock Agent
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 | No | VNStock API key | |
| 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
Each tool targets a distinct resource (stock, company, financial statement, listing, market data, fund) with a specific action. The prefixes stock_, company_, financial_, listing_, trading_, fx_, crypto_, world_index_, and fund_ cleanly separate domains with no overlapping purposes.
The naming follows a consistent category_prefix + noun pattern (stock_history, company_overview, financial_ratio, listing_all_symbols). The intraday vs history distinction is slightly odd (temporal vs derivative terms) but broadly consistent. Minor deviations like trading_price_board vs the rest don't undermine readability.
21 tools is on the upper boundary but the scope is genuinely broad: Vietnam stock market data (core), company fundamentals, financial statements, listing info, plus supplementary FX/crypto/world index/mutual fund data. Each tool maps to a distinct data category a Vietnam equity research agent would need.
The surface covers the full data stack for Vietnam equity research: market data (history, intraday, depth, price board), fundamentals (financial statements, ratios), company info (overview, shareholders, officers, news, events), and listings. Minor gaps include missing order/trade execution tools and no company_announcements separate from news, but these are not core to a data-provider role.