get_historical_stock_pricesLABSCO SUMMARY
Nine tools covering the questions an equity analyst actually asks.
Prices, statements, holders, options and news in one place means a single conversation can go from how has it traded to who owns it to what are the calls priced at, without changing sources. It is market data only: nothing here places a trade.
What it is
A server over Yahoo Finance covering price history, company data, financial statements, options and analyst views.
What you get
- Historical OHLCV data with the period and interval you choose (get_historical_stock_prices)
- A full company snapshot of price, metrics and company details (get_stock_info)
- Income statement, balance sheet or cash flow, annual or quarterly (get_financial_statement)
- Major holders, institutional holders, mutual funds and insider transactions (get_holder_info)
- Options expiration dates, and the chain for one date as calls or puts (get_option_expiration_dates, get_option_chain)
- Analyst recommendations and upgrade or downgrade history (get_recommendations), dividends and splits (get_stock_actions), and the latest news for a ticker (get_yahoo_finance_news)
Requirements
Nothing to sign up for: the data comes from Yahoo Finance. You run it from a clone of the repository with Python 3.11 and uv, and it serves over SSE on port 8000 rather than stdio.
Setup effort
Build from source — git clone https://github.com/atishayjn/yfinance-mcp.git
USE CASES
01
Checking how a stock has traded
Pull the OHLCV history at the interval you want, then read dividends and splits against it.
02
Reading a company's financial health
Fetch the quarterly or annual statement alongside the company metrics.
03
Seeing who owns a company and what insiders are doing
Read major and institutional holders plus insider transactions in one call.
04
Pricing an options trade
List the expiration dates, then pull the calls or puts chain for the one you want.
05
Catching up on the story behind a move
Read the recent news for the ticker and the analyst upgrades and downgrades together.
9 tools
Listed in project docs. Your client may show a different list.
get_stock_infoget_yahoo_finance_newsget_stock_actionsget_financial_statementget_holder_infoget_option_expiration_datesget_option_chainget_recommendationsBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- Python 3.11+
- uv on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/atishayjn/yfinance-mcp.git
cd yfinance-mcp
uv run server.pyLeave it running: this fork's server.py serves MCP over SSE at http://localhost:8000/sse instead of stdio, so clients connect to that URL
MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"yfinance": {
"url": "http://localhost:8000/sse"
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport sse yfinance http://localhost:8000/sse
