VNStock MCP Server

What is VNStock MCP Server?

VNStock MCP Server is an unofficial MCP server that provides Vietnamese stock market financial data. It allows you to interact with your Claude Desktop using natural language processing capabilities to query financial statements, ratios, company information, and more.

How to use VNStock MCP Server?

Install from PyPI by running uvx vnstock-mcp@latest. Then add one of the provided configurations to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json). For remote access, connect to a hosted instance via a Streamable HTTP endpoint at /mcp.

Key features of VNStock MCP Server

• Dual Transport Support: auto-detects STDIO or HTTP transport
• Cloud Deployment: one-click deploy to Render.com free tier
• LLM-Powered: natural language processing with Anthropic Claude
• Beautiful Output: formatted tables, charts, and data visualization
• Tool Management: automatic tool discovery and validation
• Smart Parsing: Vietnamese stock symbol and date format support
• Error Handling: robust error recovery and user-friendly messages

Use cases of VNStock MCP Server

• Query financial statements for Vietnamese stocks (e.g., “Show me FPT's income statements for 2024”)
• Retrieve financial ratios (e.g., “What are HPG's key financial ratios?”)
• Access company information and mutual fund data
• Integrate with Claude Desktop for natural language financial analysis

FAQ from VNStock MCP Server

What data sources does VNStock MCP Server use?

Financial statements and ratios use vnstock’s Finance(source="KBS") adapter. Company information uses Company(source="VCI"). Mutual fund data uses the top-level Fund adapter.

How do I install VNStock MCP Server?

Run uvx vnstock-mcp@latest in your terminal. Then add the appropriate configuration to your Claude Desktop config file as described in the README.

How do I connect to a remote instance of VNStock MCP Server?

Use the server URL https://your-app.onrender.com/mcp and add it as a remote MCP server in your client (e.g., Claude Desktop Settings > MCP Servers, or claude mcp add).

What transport protocols are supported?

The server supports both STDIO (local) and HTTP (cloud) transport, with auto-detection.

Is there a health endpoint for VNStock MCP Server?

Yes, a /health endpoint returns the server version when running from a tagged git checkout or package metadata.