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

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise