Finance

Provides real-time financial data from Yahoo Finance through MCP, including stock prices, history, metrics, and comparisons.

python

0

GitHub Stars

python

Language

6 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": {
    "mcp-mirror-dino65-dev_finance_mcp-server": {
      "command": "python",
      "args": [
        "/absolute/path/to/yfinance_mcp_server.py"
      ]
    }
  }
}

This MCP server lets you access real-time financial data from Yahoo Finance through the Model Context Protocol, enabling AI models to query stock prices, historical data, metrics, and more in real time. It’s designed for seamless integration with MCP clients so you can build conversational or analytical tools that reason about finance data as part of your AI workflows.

How to use

You connect an MCP client to this server and start asking for stock information just like you would query a data service. Use the supported tools to retrieve current prices, historical performance, company metrics, and comparisons across stocks. You can search for stocks by name or keywords and access data through structured resource URIs.

How to install

git clone https://github.com/dino65-dev/Finance_mcp-server.git

python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

pip install -r requirements.txt

python yfinance_mcp_server.py

The server will run as a stdin/stdout process that communicates via the MCP protocol.

## Connecting clients: configuration examples

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

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


These blocks show how to configure an MCP client to launch the local Python MCP server and connect to it.

Notes and troubleshooting

Prerequisites include Python 3.9 or higher and the yfinance package. If you encounter connection issues, ensure the server process is running and that the client configuration points to the correct path to yfinance_mcp_server.py. If using a virtual environment, confirm it is activated before launching the server.

Available tools

get_stock_price

Fetches the current price for a specified stock symbol.

get_historical_data

Retrieves historical price data for a symbol over a chosen period.

get_stock_metric

Returns a specific financial metric for a company, such as market cap or P/E ratio.

compare_stocks

Compares multiple stocks by given metrics like price, volume, or performance.

search_stocks

Finds stocks by company name or keywords.