Advertise
MCP.so
Sign In

VNStock MCP Server

@gahoccode

Repository

Basic information

Category

Other

Transports

stdio

Author

gahoccode

About VNStock MCP Server

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

#vnstock#stock-prices#mcp-server

VNStock MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "vnstock-mcp": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

VNStock MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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`).

4

What transport protocols are supported?

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

5

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

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

🚀 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
Advertise