Financial Datasets MCP Server
Introduction
This is a Model Context Protocol (MCP) server that provides access to stock market data from Financial Datasets.
It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.
Available Tools
This MCP server provides the following tools:
- get_income_statements: Get income statements for a company.
- get_balance_sheets: Get balance sheets for a company.
- get_cash_flow_statements: Get cash flow statements for a company.
- get_current_stock_price: Get the current / latest price of a company.
- get_historical_stock_prices: Gets historical stock prices for a company.
- get_company_news: Get news for a company.
- get_available_crypto_tickers: Gets all available crypto tickers.
- get_crypto_prices: Gets historical prices for a crypto currency.
- get_historical_crypto_prices: Gets historical prices for a crypto currency.
- get_current_crypto_price: Get the current / latest price of a crypto currency.
Setup
Prerequisites
- Python 3.10 or higher
- uv package manager
Installation
-
Clone this repository:
git clone https://github.com/financial-datasets/mcp-server cd mcp-server
-
If you don't have uv installed, install it:
# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows curl -LsSf https://astral.sh/uv/install.ps1 | powershell
-
Install dependencies:
# Create virtual env and activate it uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies uv add "mcp[cli]" httpx # On Windows: uv add mcp[cli] httpx
-
Set up environment variables:
# Create .env file for your API keys cp .env.example .env # Set API key in .env FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
-
Run the server:
uv run server.py
Connecting to Claude Desktop
-
Install Claude Desktop if you haven't already
-
Create or edit the Claude Desktop configuration file:
# macOS mkdir -p ~/Library/Application\ Support/Claude/ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
-
Add the following configuration:
{ "mcpServers": { "financial-datasets": { "command": "/path/to/uv", "args": [ "--directory", "/absolute/path/to/financial-datasets-mcp", "run", "server.py" ] } } }
Replace
/path/to/uvwith the result ofwhich uvand/absolute/path/to/financial-datasets-mcpwith the absolute path to this project. -
Restart Claude Desktop
-
You should now see the financial tools available in Claude Desktop's tools menu (hammer icon)
-
Try asking Claude questions like:
- "What are Apple's recent income statements?"
- "Show me the current price of Tesla stock"
- "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"
Metadata
Release files for iflow-mcp_financial-datasets-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_financial_datasets_mcp_server-0.1.0.tar.gz | 5.2 kB | Without provenance | Details for iflow_mcp_financial_datasets_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_financial_datasets_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_financial_datasets_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 11.3 kB
Release files / iflow_mcp_financial_datasets_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_financial_datasets_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 5.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c1d1741256c01abdab05e163e369fe9d0e04c53a983802de7aed5d8101bda75d
|
|
BLAKE2b-256 checksum How to use checksums |
f0423161c71987595f6bf11a20cc9d50ccebce807cf818e4cf3d80f5a8f1f1bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Release files / iflow_mcp_financial_datasets_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_financial_datasets_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
24b78a3a92108be43019d82b4df459175e202756ecc0bd205ad1a398658ce4c4
|
|
BLAKE2b-256 checksum How to use checksums |
700f05be73409a2822de9bffe5de091255928ffb54097e0dc2730215c2a533d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Security for iflow-mcp_financial-datasets-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.