A minimal, educational MCP server that provides a single stock snapshot tool using the free Alpha Vantage API.
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":"stock-snapshot-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.
# 📈 Stock Snapshot MCP *A minimal, educational MCP server for stock snapshots using the free Alpha Vantage API.* **Stock Snapshot MCP** is a tiny, easy-to-read reference implementation of a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server. It exposes a **single, clean tool**: ```get_stock_snapshot(symbol, history_days=60)``` This tool queries the free Alpha Vantage API and returns: - Company metadata (name, sector, industry, exchange, currency) - Latest quote (price, change, percent, previous close, volume) - Basic fundamentals (PE ratio, EPS, market cap, ROE, profit margin — if available) - Recent OHLCV price history (daily candles) This project is ideal for: - People learning MCP through a small, realistic example - Developers building **RAG-ready financial research agents** - Students who want a simple MCP server to extend or customize - Anyone experimenting with Claude / ChatGPT MCP integrations - Mini-projects where clean, structured stock data is useful > **Note:** This project is *not* affiliated with Alpha Vantage. > It is designed solely as an educational reference. > **Not for real trading or investment decisions.** --- ## ✨ Features - 📦 **Lightweight Python package** (`pip install stock-snapshot-mcp`) - 🔌 **MCP server (stdio)** compatible with Claude Desktop, ChatGPT MCP, and other tools - 🔍 Clean JSON output suitable for LLM reasoning & agent pipelines --- ## ⚙️ Installation ### **1. Install the package** ```bash pip install stock-snapshot-mcp ``` ### **2. Set your Alpha Vantage API key** Create a .env file or export it: ```bash export ALPHAVANTAGE_API_KEY=your_key_here ``` --- ## 🚀 Running the MCP server Once installed: ```bash stock-snapshot-mcp ``` This launches the MCP server over stdio, ready to be used by MCP-compatible clients. To see logs: ```bash STOCK_SNAPSHOT_MCP_LOG=info stock-snapshot-mcp ``` --- ## 🧪 Testing locally (Python) You can call the helper function directly:…
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.