Server data from the Official MCP Registry
Real-time Yahoo Finance data: quotes, history, financials, analyst ratings, options, and news.
Real-time Yahoo Finance data: quotes, history, financials, analyst ratings, options, and news.
This Yahoo Finance MCP server is well-structured with no security vulnerabilities or malicious patterns. Authentication is not required (as expected for a public data API), permissions are appropriate for its category (network_http and env_vars are standard for finance servers), and code quality is high with proper error handling and input validation. Minor low-severity findings around exception handling breadth do not materially impact the security posture. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.
4 files analyzed ยท 10 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-danishashko-yahoo-finance-mcp": {
"args": [
"-y",
"yahoo-finance-mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
Real-time stock market data for Claude Desktop and any MCP-compatible client, powered by Yahoo Finance. Get quotes, historical prices, company profiles, financial statements, analyst ratings, and multi-stock comparisons, all from natural language.
npm package:
yahoo-finance-mcp-serverย ยทย GitHub repo:danishashko/yahoo-finance-mcp. The repo name is shorter than the package name; both refer to this project.
Every tool returns human-readable markdown by default, or structured JSON on request (response_format: "json"). Requests share a single browser-impersonating HTTP session to reduce Yahoo Finance rate-limiting.
Add this to your Claude Desktop config and restart Claude:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"yahoo-finance": {
"command": "npx",
"args": ["-y", "yahoo-finance-mcp-server"]
}
}
}
That is it. On first launch the npx wrapper creates an isolated Python environment and installs the dependencies for you (a one-time step that can take a minute). You only need Python 3.10+ and Node.js 16+ on your machine.
npm install -g yahoo-finance-mcp-server
{
"mcpServers": {
"yahoo-finance": {
"command": "yahoo-finance-mcp-server"
}
}
}
| Tool | What it returns | Parameters |
|---|---|---|
get_stock_quote | Current price, change, day and 52-week range, volume, market cap, P/E, EPS, dividend yield | ticker |
get_historical_prices | OHLCV history with summary stats and total return | ticker, period, interval |
get_company_info | Business summary, key executives, valuation and financial highlights | ticker |
get_financial_statements | Annual income statement, balance sheet, and cash flow | ticker |
compare_stocks | Key metrics for multiple tickers side by side, plus quick insights | tickers (2 to 10) |
get_analyst_recommendations | Price targets, consensus, recommendation trend, and recent upgrades/downgrades | ticker |
get_market_news | Latest news headlines with source, date, summary, and link | ticker, count |
get_options_chain | Expiration dates, or the calls/puts chain (strike, bid/ask, volume, OI, IV) | ticker, expiration_date, option_type |
get_holders | Institutional, mutual-fund, or major holders, or insider transactions | ticker, holder_type |
get_dividends_splits | Dividend payment history (with summary) and stock-split history | ticker |
get_analyst_estimates | Forward price targets, EPS/revenue estimates by period, and growth estimates | ticker |
search_symbols | Find ticker symbols by company name or keyword | query, count |
get_market_status | Whether a market is open/closed, with timing and a major-index summary | region |
Every tool also accepts response_format ("markdown", the default, or "json").
get_historical_prices options:
period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, maxinterval: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3moget_options_chain: call without expiration_date to list available dates, then again with a date. option_type is calls, puts, or both.
get_holders: holder_type is institutional, mutualfund, major, or insider_transactions.
Once the server is connected, just ask Claude:
If you would rather run the Python file directly instead of via npx:
1. Download the server
Save yahoo_finance_mcp.py somewhere on your machine and install the dependencies:
pip install yfinance curl_cffi pandas tabulate mcp pydantic httpx
(or pip3 on macOS/Linux)
2. Point Claude Desktop at it
{
"mcpServers": {
"yahoo-finance": {
"command": "python3",
"args": ["/absolute/path/to/yahoo_finance_mcp.py"]
}
}
}
On Windows use "command": "python" and a path like "C:\\path\\to\\yahoo_finance_mcp.py" (double backslashes or forward slashes).
3. Restart Claude Desktop.
"Command not found" / "Python not found"
Make sure Python and Node.js are installed and on your PATH. On macOS/Linux, try python3 instead of python in the config.
"Module not found: yfinance" (manual install only) Install the dependencies:
pip install yfinance curl_cffi pandas tabulate mcp pydantic httpx
Tools not showing up in Claude
"Error fetching data"
AAPL, not Apple).yfinance library.AAPL, MSFT, TSLA).See CHANGELOG.md for the full version history. The core fixes (tool input validation, analyst recommendations, dividend yield, working npx install) landed in v1.1.0.
This tool uses Yahoo Finance's publicly available data through the yfinance library. Yahoo!, Y!Finance, and Yahoo! Finance are registered trademarks of Yahoo, Inc. This tool is not affiliated with, endorsed by, or vetted by Yahoo, Inc. Please refer to Yahoo!'s terms of use for details on your rights to use the data.
Daniel Shashko
MIT ยฉ Daniel Shashko
Be the first to review this server!
by Toleno ยท Developer Tools
Toleno Network MCP Server โ Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace ยท Developer Tools
Create, build, and publish Python MCP servers to PyPI โ conversationally.
by Microsoft ยท Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption