VNStock MCP Server

Name: VNStock MCP Server
Author: gahoccode

@gahoccode

Repository

About VNStock MCP Server

The unofficial MCP server for the vnstock package, designed and tested for Claude Desktop

#vnstock #stock-prices #mcp-server

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.

Comments

More Other MCP servers

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K