narumiruna/yfinance-mcp

Overview

An MCP server that uses yfinance to fetch financial data from Yahoo Finance. It exposes stock information through the Model Context Protocol for integration with AI agents.

Best for

Best for
Developers building AI agents that need quick access to stock market data via the Model Context Protocol

Use cases

• Retrieving real-time stock prices and historical data for analysis
• Accessing financial statements and key metrics for investment research
• Integrating market data into AI-driven portfolio or trading tools

How to use

Tools exposed

• max_rows
• search_type
• top_type
• top_n
• query_type
• sort_field
• sort_asc
• user_id
• user_id_type
• min_percent_change
• min_price
• min_volume
• min_market_cap
• chart_type
• expiration_date
• option_type

Example client config

{\n  "mcpServers": {\n    "yfmcp": {\n      "command": "uvx",\n      "args": ["yfmcp@latest"]\n    }\n  }\n}

Notes

An MCP server that uses yfinance to fetch financial data from Yahoo Finance. It exposes stock information through the Model Context Protocol for integration with AI agents.

149 stars on GitHub. Last updated 2026-05-16. Licensed MIT.

Use cases

• Retrieving real-time stock prices and historical data for analysis
• Accessing financial statements and key metrics for investment research
• Integrating market data into AI-driven portfolio or trading tools

Pros

• Leverages the popular yfinance library for reliable Yahoo Finance data
• Simple MCP interface fits neatly into AI agent workflows
• Written in Python and open source for easy customization

Cons

• Depends on Yahoo Finance’s unofficial API which may change or throttle
• Limited to data available through yfinance, no futures or options chains
• Not production grade for high-frequency or guaranteed availability needs

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.