VNStock MCP Server
@gahoccode
About VNStock MCP Server
The unofficial MCP server for the vnstock package, designed and tested for Claude Desktop
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"vnstock-mcp": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
More Other MCP servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Awesome Mcp Servers
punkpeyeA collection of MCP servers.
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Comments