This project provides a Model Context Protocol (MCP) server for accessing financial market data, enabling AI assistants like Claude to retrieve company financial statements, stock prices, and market news. It targets AI developers and researchers who need programmatic access to real-time and historical financial data.

How It Works

The server exposes a set of tools via the MCP interface, allowing AI models to query specific financial data points. It acts as a bridge between AI assistants and the Financial Datasets API, abstracting the complexities of API calls and data retrieval. This approach simplifies data access for AI-driven financial analysis.

Quick Start & Requirements

• Install dependencies using uv: uv venv, source .venv/bin/activate, uv add "mcp[cli]" httpx.
• Requires Python 3.10+ and the uv package manager.
• Set FINANCIAL_DATASETS_API_KEY in a .env file.
• Run the server with uv run server.py.
• Official documentation and setup guides are available within the README.

Highlighted Details

• Provides tools for income statements, balance sheets, cash flow statements, stock prices, and company news.
• Includes functionality for both stock and cryptocurrency data, including historical prices.
• Supports integration with Claude Desktop via a configuration file.

Maintenance & Community

The project is maintained by financial-datasets. Further community or roadmap information is not detailed in the README.

Licensing & Compatibility

The license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project requires a Financial Datasets API key, which may incur costs. The README does not specify the license, which could impact commercial adoption.