Yahoo Finance

You can access Yahoo Finance data through an MCP (Model Context Protocol) server that provides structured tools for market data. This server exposes financial data endpoints via MCP transports and is designed to be consumed by MCP clients for reliable, streaming access to historical prices, stock info, news, financial statements, and more.

How to use

Connect to the Yahoo Finance MCP Server using an MCP client to access a suite of data tools. You can run the server locally during development and deploy it to a cloud environment for production use. Once connected, you can request OHLCV data, stock fundamentals, news, dividends and splits, financial statements, holder information, option data, and analyst recommendations. The server supports both server-sent events (SSE) and Streamable HTTP transports, so you can choose the transport that best fits your client implementation.

Two common ways to connect from a client are through an SSE endpoint for real-time streaming or via a standard HTTP transport that can be proxied through MCP tooling. To start a local connection, you can point your client to the local SSE URL and test with the provided MCP transports.

How to install

Prerequisites you need before installation: Node.js (and npm) installed on your machine.

Step 1: Install dependencies for the server.

Step 2: Run the development server to test locally.

Step 3: Deploy the server to your hosting environment (Cloudflare Workers in the example).

Additional notes

The server includes 9 data tools for Yahoo Finance access, and uses Cookie + Crumb authentication for reliable API access. It supports SSE and Streamable HTTP transports and is designed to work with Cloudflare Workers, including Durable Objects for state management.

Configuration and usage details

You can connect to the server using the following client commands as examples. The snippets show a local setup and a deployed setup for the SSE transport.

Available tools

get_historical_stock_prices

Get OHLCV data for a ticker. Retrieve open, high, low, close, and volume information for specified time ranges.

get_stock_info

Get comprehensive stock information including price, market cap, sector, and other fundamentals.

get_yahoo_finance_news

Get latest news for a ticker, including headlines and brief summaries.

get_stock_actions

Get dividends and stock splits for a ticker and date range.

get_financial_statement

Get income statement, balance sheet, or cashflow data for a company.

get_holder_info

Get institutional, insider, and major holders information.

get_option_expiration_dates

Get available option expiration dates for a ticker.

get_option_chain

Get calls/puts option chain for a given expiration date.

get_recommendations

Get analyst recommendations and sentiment for a ticker.