Yahoo Finance MCP
The yfmcp MCP server with Yahoo Finance data: quotes, statements, news, options, holders and charts as images
- 209 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The server only reads public Yahoo Finance data and does not touch your accounts
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/yahoo-finance-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The server only reads public Yahoo Finance data and does not touch your accounts
This is third-party code. Review the repository files before installing.
What it does
yfmcp is an MCP server over the yfinance library. An agent gets Yahoo Finance data by ticker: company information and valuation metrics, dividends, income statement and balance sheet with history, news and press releases, analyst consensus, upgrades and downgrades. Search finds stocks, ETFs and news, and sector rankings show top ETFs, funds and companies. Price history comes back as a Markdown table or as candlestick, VWAP and volume profile charts in WebP images. There are option chains with strikes, implied volatility and expiration dates, holder and insider transaction data, ETF and mutual fund look-through and predefined screeners. Each tool validates the ticker before calling Yahoo Finance and returns `INVALID_PARAMS` on bad input.
Who it is for. Analysts and private investors who review securities, statements and options in a chat with an agent and want no paid API.
Good fit when
- An agent compares analyst consensus and recent upgrades for a pair of tickers
- You want a candlestick chart with VWAP for the last quarter as an image in the reply
- Before a trade you want the option chain for the nearest expiration with strikes and volatility
- The agent breaks down an ETF's holdings and sector split
Not a fit when
- You need orders and trades: the server only reads data
- You need licensed terminal-grade data with guarantees: Yahoo Finance is a public source with no commitments
- You need the Russian market and MOEX quotes: the README does not list such coverage
Example request
Show a three-month candlestick chart of VOO with VWAP, give the analyst consensus targets and the nearest option expiration datesMCP
- Transport
- stdio
- Authentication
- not required
Limitations
Data comes from Yahoo Finance through the unofficial yfinance library, so completeness and field availability depend on the ticker and may change. The validator accepts only ASCII letters, digits and the characters `.`, `-`, `^`, `=`, `&`, `_` and does not check that a ticker exists. Running needs uv or Docker, and building from source needs Python 3.12 or newer. The data is for reference and is not investment advice. The package is called `yfmcp` on PyPI and the license is MIT.
How to disable. Remove the server from the client (`claude mcp remove yfmcp`). It leaves no data on your side.
FAQ
How do I install yfmcp?
Install uv and add a server with the `uvx` command and the `yfmcp@latest` argument to the client config. Without uv the image runs with `docker run -i --rm narumi/yfinance-mcp`.
Do I need an API key?
No, data comes from Yahoo Finance through the yfinance library without a key.
What charts can it draw?
Candlestick, VWAP and volume profile, returned as a WebP image. Price history can also be a Markdown table.
What does the server do with a bad ticker?
It checks the format before calling Yahoo Finance and returns `INVALID_PARAMS` without echoing the input. The check does not prove the ticker exists.
Which ticker formats are accepted?
For example `BRK.B`, `2330.TW`, `^GSPC`, `EURUSD=X`, `ES=F` and `BTC-USD`.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
An unofficial Yahoo Finance client with an MCP server, a CLI and an agent skill: quotes, price history, financial statements and options for an agent
An MCP server for personal stock analysis: market data, technical indicators, screening and portfolio tracking, no keys for the core
A financial analysis MCP server: 500+ methods from company statements, ratios, indicators, risk metrics and macro data
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
README in short
The text lists the server's features, then describes each tool with a parameter table and its result. Three ways to run follow: uv, Docker and source, a Codex CLI test, development and a demo chatbot.