MCP Catalogs
Home

mcp-yfinance

by 9nate-drake·19·Score 34

MCP server providing Yahoo Finance data through yfinance API to Claude Desktop.

financeai-llm
5
Forks
3
Open issues
18 mo ago
Last commit
2d ago
Indexed

Overview

The mcp-yfinance server is a specialized Model Context Protocol implementation that bridges Claude Desktop with Yahoo Finance's financial data through the yfinance Python library. It enables Claude to access real-time stock prices, historical performance data, institutional ownership information, and analyst price targets directly within conversations. The server transforms financial queries into API calls and returns structured data that Claude can use for analysis and reporting.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Get current stock prices and market data for various companies
you:Analyze historical stock performance over custom time periods
you:Retrieve institutional ownership and analyst price target information
you:How do I use the yfinance MCP server?
you:Where do I find the server.py file?

When to choose this

Choose this when you need financial data access directly in Claude Desktop without switching between applications.

When NOT to choose this

Don't choose this if you need highly specialized financial analysis tools or data from sources beyond Yahoo Finance.

Tools this server exposes

4 tools extracted from the README
  • get_current_stock_price

    Get the current stock price for a given ticker symbol

  • get_historical_data

    Retrieve historical stock price data for analysis

  • check_ownership

    Check institutional ownership information for a stock

  • check_analyst_targets

    Retrieve analyst price target information for a stock

Note: Tool names inferred from example queries in the README as no explicit tool section was provided

Comparable tools

alpha-vantage-mcpfinancial-modeling-prep-mcppython-yfinance-direct

Installation

Installation

Requirements

  • Python 3.10 or higher
  • Claude Desktop

Install Steps

  1. Clone this repo:
git clone https://github.com/9nate-drake/mcp-yfinance
  1. Install required packages:
pip install mcp yfinance

Configuration

Add to your Claude Desktop config file claude_desktop_config.json:

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

FAQ

How do I use the yfinance MCP server?
After installation and configuration, restart Claude Desktop. You can then use natural language queries like 'Get me the current stock price for MSFT' or 'Analyze the last 3 months of Apple stock performance'.
Where do I find the server.py file?
The server.py file is in the finance_server directory within the cloned repository. You'll need to provide the full path to this file in your Claude Desktop configuration.

Compare mcp-yfinance with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.