Financial DatasetsSAFE
An MCP server for interacting with the Financial Datasets stock market API.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
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 ke
2913ef2c468bOBSERVED · 2026-09-23Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcp-server --env FINANCIAL_DATASETS_API_KEY=${FINANCIAL_DATASETS_API_KEY} -- uvx mcp-server{
"mcpServers": {
"mcp-server": {
"command": "uvx",
"args": [
"mcp-server"
],
"env": {
"FINANCIAL_DATASETS_API_KEY": "${FINANCIAL_DATASETS_API_KEY}"
}
}
}
}Exposed tools (11)
11 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get_available_crypto_tickers | read | |
get_balance_sheets | read | Get balance sheets for a company. |
get_cash_flow_statements | read | Get cash flow statements for a company. |
get_company_news | read | Get news for a company. |
get_crypto_prices | read | |
get_current_crypto_price | read | Get the current / latest price of a crypto currency. |
get_current_stock_price | read | Get the current / latest price of a company. |
get_historical_crypto_prices | read | Gets historical prices for a crypto currency. |
get_historical_stock_prices | read | Gets historical stock prices for a company. |
get_income_statements | read | Get income statements for a company. |
get_sec_filings | read | Get all SEC filings for a company. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (1)
curl -LsSf https://astral.sh/uv/install.sh | sh
Gates applied: no_behavioural_pass.
2913ef2c468bfull audit observations/trust-audit/mcp-server/financial-datasets__financial-datasets.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-09-23 | 2913ef2c468b | SAFE | B | 89 | source changed, verdict held |
Questions
What is the Financial Datasets MCP server?
An MCP server for interacting with the Financial Datasets stock market API.
What tools does Financial Datasets expose?
11 in total: 11 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Financial Datasets safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Financial Datasets need?
It reads FINANCIAL_DATASETS_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Financial Datasets run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as mcp-server.
How current is this page?
The grade is for one exact copy of the source (2913ef2c468b), read on 2026-09-23. The repository is watched and re-audited when it changes.