VNStock

You can access Vietnam stock market data through a dedicated MCP server that exposes a wide range of datasets and tools. It acts as a bridge between the vnstock library and MCP clients, enabling you to query real-time and historical quotes, financial statements, market data, fund information, and more in a standardized MCP interface.

How to use

Start the server in the mode that fits your setup, then connect your MCP client to it. You can run the server locally and access it via standard input/output, via a web-friendly streaming endpoint, or via HTTP streaming for API-driven integrations. Choose the transport that best matches your environment and client capabilities, then request data such as stock quotes, financial statements, and market data through the MCP endpoints.

How to install

Prerequisites you need before installation are Python 3.10 or newer and the uv runtime. Install uv if it is not already present.

pip install uv

pip install vnstock-mcp-server

Configuration and usage notes

The server supports three transport modes to cover typical usage scenarios: stdio (default), SSE for web apps, and streamable HTTP for API or microservice workflows.

Default stdio mode is suitable for desktop MCP clients. SSE mode is ideal for web dashboards and browser-based clients. HTTP streaming mode is designed for API integrations.

To start with the default stdio setup after installation, run the command below. If you installed from source using uv, you can start the server with the corresponding uv-based command.

Examples and quick-start configurations

{
  "mcpServers": {
    "vnstock": {
      "command": "vnstock-mcp-server",
      "args": []
    }
  }
}

Transport options in practice

• stdio: Start with vnstock-mcp-server and connect your MCP client directly through standard input/output streams.

• SSE: Start with vnstock-mcp-server --transport sse and access the endpoint at the default address (http://127.0.0.1:8000). You can mount the SSE stream at a custom path with --mount-path if needed.

• streamable-http: Start with vnstock-mcp-server --transport streamable-http to enable HTTP streaming for API-based integrations. The server runs at the default address (http://127.0.0.1:8000).

Security and reliability notes

Limit exposure of the server to trusted networks when using SSE or HTTP transport. Employ appropriate authentication and network controls to prevent unauthorized access to data streams.

Monitor the server status and port availability. If you encounter connection issues, verify that the server is running and listening on the expected port.

Troubleshooting

If the MCP client cannot connect over stdio, verify the client configuration matches the installation method and that no extra arguments are being passed for stdio transport.

If SSE/HTTP endpoints are unreachable, ensure the server is running and listening on port 8000. Check server logs for startup errors and confirm the mount path (if used) is correct.

Notes on development and maintenance

This MCP server is built as a wrapper around vnstock, exposing its capabilities through MCP tools. Regularly update both the underlying vnstock library and the MCP server to benefit from new data sources and tooling.

Available tools

Company Information

Access company overview, news, events, shareholders, officers, subsidiaries, and insider deals.

Financial Data

Retrieve income statements, balance sheets, cash flows, financial ratios, and raw reports.

Market Data

Get real-time quotes, historical prices, intraday data, and price depth.

Fund Information

List and search mutual funds, with NAV reports and holdings.

Miscellaneous

Access gold prices, exchange rates, and symbol listings by industry.