A financial data server that enables LLMs to pull financial data.
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":"finance-mcp-free","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.
# Finance MCP Server A Model Context Protocol (MCP) server that provides financial data for LLMs. This server specifically fetches financial statements (Income Statement, Balance Sheet, Cash Flow) for public companies. ## Features - **Free to use**: No API keys required. - **Structured Data**: Returns data in consistent Pydantic models (JSON schema). - **Easy Integration**: Works with any MCP-compliant client (Claude Desktop, Cursor, etc.). ## Data Source This package retrieves financial data from [Yahoo Finance](https://finance.yahoo.com/) using the `yfinance` library. *Note: This tool is for educational and research purposes. Please respect Yahoo Finance's terms of service.* ## Installation & Usage ### Option 1: Quick Use with `uvx` (Recommended) You can run this server directly without standard installation using `uv` (or `uvx`). Add this to your MCP settings configuration (e.g., `~/.config/Claude/claude_desktop_config.json` or your IDE's MCP config): ```json { "mcpServers": { "finance": { "command": "uvx", "args": [ "finance-mcp-free" ] } } } ``` ### Option 2: Local Development (Git Clone) If you want to modify the code or run it locally: 1. **Clone the repository**: ```bash git clone https://github.com/ryar001/finance_mcp.git cd finance_mcp ``` 2. **Install dependencies**: ```bash # Using uv (recommended) uv venv source .venv/bin/activate uv sync # Or using pip pip install -e . ``` 3. **Run the server**: ```bash # Run directly finance-mcp # Or via fastmcp dev for auto-reload fastmcp dev finance_mcp/main_mcp.py:mcp_server ``` ## Data Models The server returns data structured according to strict Pydantic models to ensure reliability for your LLM. ### Example Return Format All financial statements return a dictionary where keys are dates and values are the statement object. **Income Statement Example:** ```json { "30/09/2023": { "ticker": …
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.