{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_uhhvy9yek2vh","handle":"mcp-finnhub","url":"https://wellknown.network/agents/mcp-finnhub","links":{"self":"https://wellknown.network/agents/mcp-finnhub/record.json","html":"https://wellknown.network/agents/mcp-finnhub","markdown":"https://wellknown.network/agents/mcp-finnhub/record.md","api":"https://wellknown.network/api/v1/agents/mcp-finnhub","status":"https://wellknown.network/api/v1/agents/mcp-finnhub/status","claim":"https://wellknown.network/agents/mcp-finnhub/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-finnhub/claim.json","badge":"https://wellknown.network/agents/mcp-finnhub/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-finnhub/history","tools":"https://wellknown.network/api/v1/agents/mcp-finnhub/tools"},"ard":{"identifier":"urn:air::server:mcp-finnhub","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-finnhub","summary":"Model Context Protocol server for Finnhub financial market data API","description":"# mcp-finnhub\n\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-2024--11--05-green.svg)](https://modelcontextprotocol.io)\n\nModel Context Protocol (MCP) server providing comprehensive access to [Finnhub](https://finnhub.io) financial market data API. Built for AI assistants like Claude Desktop to seamlessly access real-time market data, technical indicators, fundamentals, and alternative data.\n\n## Features\n\n- **15 MCP Tools** covering 100+ Finnhub API endpoints\n- **Real-time market data**: Quotes, candles, tick data, BBO\n- **Technical analysis**: 50+ indicators, patterns, support/resistance\n- **Fundamentals**: Financials, earnings, dividends, metrics\n- **Alternative data**: ESG scores, social sentiment, supply chain\n- **Multi-asset support**: Stocks, crypto, forex, ETFs, bonds\n- **Project-based storage** with automatic CSV/JSON exports\n- **Background job processing** for large datasets\n- **Smart output handling** with token estimation\n- **Configurable tools** - enable only what you need\n- **AI-friendly errors** - Structured error responses with guidance\n- **Built-in help** - Every tool supports `operation=\"help\"` for discovery\n\n## Quick Start\n\n### Prerequisites\n\n- Python 3.11 or higher\n- [Finnhub API key](https://finnhub.io/register) (free tier available)\n- [Claude Desktop](https://claude.ai/download) or compatible MCP client\n\n### Installation\n\n#### Option 1: Install from PyPI (coming soon)\n\n```bash\npip install mcp-finnhub\n```\n\n#### Option 2: Install from source\n\n```bash\ngit clone https://github.com/cfdude/mcp-finnhub.git\ncd mcp-finnhub\npip install -e .\n```\n\n### Configuration\n\n1. Create a `.env` file in your project root:\n\n```bash\n# Required\nFINNHUB_API_KEY=your_api_key_here\nFINNHUB_STORAGE_DIR=/path/to/storage\n\n# Optional - Tool configuration\nFINNHUB_ENABLE_TECHNI…","publisher":null,"homepage":"https://github.com/cfdude/mcp-finnhub/blob/main/README.md","repository":"https://github.com/cfdude/mcp-finnhub/blob/main/CHANGELOG.md","version":"1.1.1","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","finnhub","financial-data","stock-market","technical-indicators","api","claude"],"pricing":null,"endpoints":[{"url":"pypi:mcp-finnhub","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"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","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":"mcp-finnhub","registry":"pypi","observedAt":"2026-11-03T13:26:40.207Z","publishedAt":"2025-12-03T02:22:00.655924Z","latestVersion":"1.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-finnhub","url":"https://pypi.org/project/mcp-finnhub/","firstSeenAt":"2026-09-10T01:20:51.423Z","fetchedAt":"2026-11-03T13:25:21.512Z","normalizedAt":"2026-11-03T13:25:21.512Z"}]},"firstSeenAt":"2026-09-10T01:20:51.423Z","updatedAt":"2026-11-03T13:26:40.207Z"}