Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"vnstock-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# VNStock MCP Server The unofficial MCP server that provides Vietnamese stock market financial data, allowing you to interact with your Claude Desktop using natural language processing capabilities. ## Features - 🚀 **Dual Transport Support**: Auto-detects STDIO (local) or HTTP (cloud) 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 ## Quick Start ### 1. Installation **For End Users (Recommended)** ```bash # Install from PyPI and run directly uvx vnstock-mcp@latest ``` **For Developers** ```bash # Clone the repository git clone https://github.com/gahoccode/vnstock-mcp.git cd vnstock-mcp # Install uv if you don't have it curl -LsSf https://astral.sh/uv/install.sh | sh # Install dependencies uv sync ``` ### 2. Run the Server **End Users (uvx method)** ```bash # Run directly from PyPI uvx vnstock-mcp@latest ``` **Developers (local development)** ```bash # Run from source uv run python src/vnstock_mcp/server.py ``` ## Usage Examples ``` > Show me FPT's financial statements for 2024 > What are HPG's key financial ratios? > Get VCB exchange rates for today ``` ### Project Structure ``` vnstock-mcp/ ├── pyproject.toml # Project configuration and dependencies ├── src/ │ └── vnstock_mcp/ # Python package │ ├── __init__.py # Package initialization │ ├── server.py # MCP server (API Layer) │ ├── config.py # Configuration constants │ ├── exceptions.py # Custom exceptions │ ├── core/ # Service Layer (business logic) │ │ ├── base.py # BaseService with async patterns │ │ ├── financial.py │…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.