Finance

Provides real-time financial data from Yahoo Finance to MCP clients via a Python-based server.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dino65-dev-finance_mcp-server": {
      "command": "python",
      "args": [
        "/absolute/path/to/yfinance_mcp_server.py"
      ]
    }
  }
}

You run a lightweight MCP server that feeds real-time and historical financial data from Yahoo Finance to language models and MCP clients. It lets AI systems ask for stock prices, historical performance, company information, and simple stock comparisons as if they were querying a built‑in financial data service.

How to use

To access live financial data through MCP, run the local server and connect your MCP client with the provided stdio configuration. The server exposes tools you can prompt the model to call, such as current prices, historical history, metrics, and stock comparisons.

Run the server locally so your MCP client can send requests via standard input/output.

Configure your MCP client with the following JSON for Claude Desktop to point to the local Python process.

{
  "mcpServers": {
    "yfinance": {
      "command": "python",
      "args": [
        "/absolute/path/to/yfinance_mcp_server.py"
      ]
    }
  }
}

Configure your MCP client with the following JSON for Cursor to point to the local Python process.

{
  "yfinance": {
    "command": "python",
    "args": [
      "/absolute/path/to/yfinance_mcp_server.py"
    ]
  }
}

Available tools

get_stock_price

Fetches the current price for a given public company symbol.

get_historical_data

Retrieves historical price data for a symbol over a specified time range.

get_stock_metric

Returns a specific financial metric for a given stock, such as market capitalization or PE ratio.

compare_stocks

Compares multiple symbols using chosen metrics to highlight relative performance.

search_stocks

Finds stocks by company name or descriptive keywords.