Finance MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Finance MCP Server Get the income statement for Apple"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.).
Related MCP server: Financial Datasets MCP Server
Data Source
This package retrieves financial data from Yahoo Finance 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):
{
"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:
Clone the repository:
git clone https://github.com/ryar001/finance_mcp.git cd finance_mcpInstall dependencies:
# Using uv (recommended) uv venv source .venv/bin/activate uv sync # Or using pip pip install -e .Run the server:
# 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:
{
"30/09/2023": {
"ticker": "AAPL",
"period": "30/09/2023",
"total_revenue": 89498000000,
"net_income": 22956000000,
"cost_of_revenue": 49071000000,
"gross_profit": 40427000000,
"operating_expenses": 13458000000,
"operating_income": 26969000000,
...
}
}The data is strictly typed to ensure your LLM can reliably query fields like total_revenue, net_income, etc.
Available Tools
3 toolsget_balance_sheet_toolA
Retrieve the balance sheet for a specified company.
company: The name of the company for which to retrieve the balance sheet.
Inputs: company (required). Returns: object
get_cashflow_statement_toolB
Retrieve the cash flow statement for a specified company.
company: The name of the company for which to retrieve the cash flow statement.
Inputs: company (required). Returns: object
get_income_statement_toolC
Retrieve the income statement for a specified company.
company: The name of the company for which to retrieve the income statement.
Inputs: company (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool retrieves a distinct financial statement (balance sheet, cash flow, income statement) with no overlap in functionality.
All tool names follow the 'get_{statement_type}_tool' pattern, using consistent verb-noun structure despite the redundant '_tool' suffix.
Three tools is a reasonable minimal set for a finance server focused on core financial statements, though additional tools (e.g., financial ratios) could be included.
The three primary financial statements are covered, which is complete for basic financial data retrieval; missing features like historical comparisons or sector data are minor gaps.
Related MCP Connectors
Scrape stock quotes, historical prices, and financial statements from Yahoo Finance.
Financial statements, metrics, dividends, and price data for public companies.
Clean annual and quarterly company financials from official SEC EDGAR XBRL data.
Yahoo Finance for AI agents: quotes, price history, options with Greeks, financials, news, movers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides real-time stock market data through Yahoo Finance without requiring an API key. Get quotes, historical data, company information, financial statements, and ticker search capabilities.-
- FlicenseNot gradedqualityDmaintenanceProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.-
- FlicenseNot gradedqualityDmaintenanceEnables querying Yahoo Finance data including stock prices, historical data, financial statements, dividends, news, analyst recommendations, and company information through the yfinance library.-
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive financial data from Yahoo Finance, enabling retrieval of stock prices, company information, financial statements, options data, analyst recommendations, and market news through natural language queries.MIT