Skip to main content
Glama
Finance MCP Server

Finance MCP Server

by ryar001

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:

  1. Clone the repository:

    git clone https://github.com/ryar001/finance_mcp.git
    cd finance_mcp
  2. Install dependencies:

    # Using uv (recommended)
    uv venv
    source .venv/bin/activate
    uv sync
    
    # Or using pip
    pip install -e .
  3. 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 tools
get_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

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool retrieves a distinct financial statement (balance sheet, cash flow, income statement) with no overlap in functionality.

    Naming Consistency5/5

    All tool names follow the 'get_{statement_type}_tool' pattern, using consistent verb-noun structure despite the redundant '_tool' suffix.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying Yahoo Finance data including stock prices, historical data, financial statements, dividends, news, analyst recommendations, and company information through the yfinance library.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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