Yahoo Finance

Yahoo Finance

MCP server enabling AI to access Yahoo Finance data, news, and financials.

6
Stars
7
Forks
0
Releases

Overview

Yahoo Finance MCP Server is an asyncio-powered MCP service that lets AI agents query Yahoo Finance for real-time and historical market data. It exposes a set of MCP tools to retrieve ticker details (including company information, financials, and trading metrics), fetch recent news articles related to specific symbols, and search for stocks, ETFs, and other financial instruments along with related news results. It also supports retrieving top entities by sector, historical price data with configurable periods and intervals, and option chain data (calls and puts). Earnings data, including upcoming dates, are available via the ticker-earning tool. The server supports HTTP/HTTPS/SOCKS proxies to improve reliability and help manage rate limits. Built to integrate with the MCP protocol, it aims for fast, non-blocking operation using asyncio and straightforward integration for AI assistants. Prerequisites include Python 3.11+, and common Python libraries such as yfinance, requests, pandas, and the MCP package. Installation options include uvx (recommended), pip, or running from source. Example tools include get-ticker-info, get-ticker-news, search, get-top-entities, get-price-history, ticker-option-chain, and ticker-earning.

Details

Owner
AgentX-ai
Language
Python
License
MIT License
Updated
2025-12-07

Features

Stock Data

Get comprehensive ticker information including company details, financials, and trading metrics

News Feed

Fetch recent news articles related to specific stock symbols

Search

Find stocks, ETFs, and other financial instruments with news results

Top Entities

Get top performing companies, ETFs, and mutual funds by sector

Price History

Fetch historical price data with customizable periods and intervals

Options Chain

Get option chain data for stocks including calls and puts

Earnings

Access earnings data including upcoming earnings dates

Proxy Support

Works with HTTP/HTTPS/SOCKS proxies

Tags

stock datanews feedsearchtop entitiesprice historyoptions chainearningsproxy supportasynceasy integrationYahoo Financefinance