{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6amvgxrxwegk","handle":"stock-snapshot-mcp","url":"https://wellknown.network/agents/stock-snapshot-mcp","links":{"self":"https://wellknown.network/agents/stock-snapshot-mcp/record.json","html":"https://wellknown.network/agents/stock-snapshot-mcp","markdown":"https://wellknown.network/agents/stock-snapshot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/stock-snapshot-mcp","status":"https://wellknown.network/api/v1/agents/stock-snapshot-mcp/status","claim":"https://wellknown.network/agents/stock-snapshot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/stock-snapshot-mcp/claim.json","badge":"https://wellknown.network/agents/stock-snapshot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/stock-snapshot-mcp/history","tools":"https://wellknown.network/api/v1/agents/stock-snapshot-mcp/tools"},"ard":{"identifier":"urn:air::server:stock-snapshot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"stock-snapshot-mcp","summary":"A minimal, educational MCP server that provides a single stock snapshot tool using the free Alpha Vantage API.","description":"# 📈 Stock Snapshot MCP  \n\n*A minimal, educational MCP server for stock snapshots using the free Alpha Vantage API.*\n\n**Stock Snapshot MCP** is a tiny, easy-to-read reference implementation of a  \n[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server.\n\nIt exposes a **single, clean tool**:\n```get_stock_snapshot(symbol, history_days=60)```\n\nThis tool queries the free Alpha Vantage API and returns:\n\n- Company metadata (name, sector, industry, exchange, currency)  \n- Latest quote (price, change, percent, previous close, volume)  \n- Basic fundamentals (PE ratio, EPS, market cap, ROE, profit margin — if available)  \n- Recent OHLCV price history (daily candles)\n\nThis project is ideal for:\n\n- People learning MCP through a small, realistic example  \n- Developers building **RAG-ready financial research agents**  \n- Students who want a simple MCP server to extend or customize  \n- Anyone experimenting with Claude / ChatGPT MCP integrations  \n- Mini-projects where clean, structured stock data is useful  \n\n> **Note:** This project is *not* affiliated with Alpha Vantage.  \n> It is designed solely as an educational reference.  \n> **Not for real trading or investment decisions.**\n\n---\n\n## ✨ Features\n\n- 📦 **Lightweight Python package** (`pip install stock-snapshot-mcp`)\n- 🔌 **MCP server (stdio)** compatible with Claude Desktop, ChatGPT MCP, and other tools\n- 🔍 Clean JSON output suitable for LLM reasoning & agent pipelines\n\n---\n\n## ⚙️ Installation\n\n### **1. Install the package**\n```bash\npip install stock-snapshot-mcp\n```\n### **2. Set your Alpha Vantage API key**\n\nCreate a .env file or export it:\n```bash\nexport ALPHAVANTAGE_API_KEY=your_key_here\n```\n---\n\n## 🚀 Running the MCP server\n\nOnce installed:\n```bash\nstock-snapshot-mcp\n```\n\nThis launches the MCP server over stdio, ready to be used by MCP-compatible clients.\nTo see logs:\n```bash\nSTOCK_SNAPSHOT_MCP_LOG=info stock-snapshot-mcp\n```\n\n---\n\n## 🧪 Testing locally (Python)\n\nYou can call the helper function directly:…","publisher":{"name":"Pavatharani Senthil Kumar","url":null},"homepage":"https://github.com/pforpav/stock-snapshot-mcp","repository":"https://github.com/pforpav/stock-snapshot-mcp","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:stock-snapshot-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":0.814,"provenance":"derived"}],"categories":["finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"stock-snapshot-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:56.453Z","publishedAt":"2025-12-08T13:19:23.803532Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"stock-snapshot-mcp","url":"https://pypi.org/project/stock-snapshot-mcp/","firstSeenAt":"2026-09-10T13:19:47.799Z","fetchedAt":"2026-11-04T01:23:55.101Z","normalizedAt":"2026-11-04T01:23:55.101Z"}]},"firstSeenAt":"2026-09-10T13:19:47.799Z","updatedAt":"2026-11-04T01:24:56.453Z"}