Yahoo Finance

Community

Query Yahoo Finance data through MCP.

How to install ↓ Compare GitHub source repository ↗

Category: Other #30 of 230
Stars: ★ 202 Very popular
Transport: stdio (local process)
Runtime: Python 3.12+ · Docker
Credentials: No credential needed
License: MIT
Last commit: 5 days ago
Tools: 15

66FMRS · C

Based on the repository README and server.json, this is an MIT-licensed stdio MCP server at version 0.14.0, distributed as the PyPI package yfmcp, covering Yahoo Finance stock, fund, news, screener, financial, options, and chart data. The supplied source does not establish that it is maintained by Yahoo.

Strongest · Documentation 16/20 Weakest · Reliability 10/20

Reliability

10/20

Security and permissions

14/20

Maintenance

12/20

Documentation

16/20

Setup experience

14/20

Why each score

Reliability 10/20: The manifest declares a PyPI package runnable through uvx over stdio, and the README documents the tools, parameters, and return shapes, making normal startup and handshake plausible. Points are deducted because only a CI badge and test commands are shown, without verifiable workflow contents, committed test coverage, or implementation evidence for error handling; Yahoo data availability and field variability remain unverified. The score therefore stays at or below the static cap of 12.
Security and permissions 14/20: The server is presented as a read-only interface to public Yahoo Finance market data, with no declared credentials, write actions, payments, deletion, deployment, or remote-command capability; no real secrets are shown, so no red line is triggered. Points are deducted because external network access is required and the materials do not establish data boundaries, network-failure controls, privacy behavior, or least-privilege enforcement. The optional Yahoo user identifier is also insufficiently scoped, although no sensitive credential handling is shown.
Maintenance 12/20: The project states an MIT license, version 0.14.0, is not archived, and has zero open issues; a CI badge provides some maintenance evidence. Points are deducted because the supplied material contains no commit or release history, dependency-update policy, maintainer response commitment, or security vulnerability reporting channel, so sustained maintenance and timely response cannot be verified.
Documentation 16/20: The README covers installation methods, client configuration, runtime requirements, tool parameters, return structures, limits, screener examples, chart types, and development commands. Points are deducted for missing systematic troubleshooting, network or data-source limitations, cost or rate-limit guidance, privacy boundaries, and security-response information; no independently verifiable execution results are supplied.
Setup experience 14/20: The project offers uvx, Docker, and source-install paths with MCP client configuration examples. The PyPI package, version, and stdio transport are explicit in the manifest, and the primary setup path is short. Points are deducted because the source path requires Python 3.12 or newer, uv or Docker, while platform compatibility, dependency-failure handling, and actual connection verification are unsupported by source evidence. Under the static rule, no committed tests covering key paths are shown, so the score remains at or below 15.

Static review · not runListed 2026-08-14

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

Users who need Yahoo Finance data in AI conversations
Analysts and developers researching stocks, funds, and ETFs
MCP client users who need structured financial data and charts

Not for

Production financial systems requiring guaranteed real-time, complete, or stable data
Users treating market data as investment advice or a trading decision by itself
Users requiring authentication, data sources, or client integrations not documented in the source

Required permissions

A network connection to access Yahoo Finance data
The source does not document a user login or API key requirement
Docker requires a locally available Docker runtime when using the Docker method

Risks and side effects

Yahoo Finance fields and availability may vary by symbol, fund, data version, and coverage
Analyst, holder, and fund datasets may be incomplete or partially unavailable
Screener results are subject to Yahoo Finance query limits, commonly up to 250 rows per request
Financial data and charts should not be treated as investment advice

Setup

Before you start

Runtime：Python 3.12+ · Docker

Install uv, then add the JSON in install_config to an MCP client configuration. Docker is also supported, or clone the repository and run uv sync; source development requires Python 3.12 or later.

MCP config · JSON

{"mcpServers":{"yfmcp":{"command":"uvx","args":["yfmcp@latest"]}}}

Works in clients that read an "mcpServers" key. For clients such as VS Code that use a different key, the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "yfmcp": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add yfmcp -- uvx yfmcp@latest

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After adding the mcpServers config and restarting the client, the yfinance_* tools should appear in the tool list; ask 'Show AAPL ticker info' and a JSON response with company details confirms the connection.

Troubleshooting

Confirm that uv is installed and that source installation uses Python 3.12 or later
Check the MCP client command, arguments, and JSON configuration syntax
Verify the ticker or fund symbol and whether the requested dataset is available
For custom screeners, check query_type, the query tree, sort field, and Yahoo row limits
Use the YYYY-MM-DD format for option expiration_date
Set supported max_rows values to 0 when complete tabular results are needed

Things to try

Once connected, you can ask your AI assistant things like:

Show AAPL ticker info and valuation metrics
Get the price history for MSFT over the last 3 months with interval 1d
Run the day_gainers screener and show the top 25 results
Fetch the option expiration dates for TSLA, then show the calls chain for the nearest date

Tools 15

yfinance_get_ticker_info read-only

Retrieve company information, financial data, trading metrics, valuation, dividends, and governance data.

yfinance_get_analyst_price_targets read-only

Retrieve the current price and analyst consensus price targets.

yfinance_get_analyst_estimates read-only

Retrieve analyst estimates, revision trends, recommendations, growth estimates, and earnings history.

yfinance_get_upgrades_downgrades read-only

Retrieve analyst rating actions, price-target changes, initiations, and reiterations.

yfinance_get_ticker_news read-only

Retrieve recent news articles and press releases for a ticker.

yfinance_search read-only

Search Yahoo Finance for stocks, ETFs, and news.

yfinance_get_top read-only

Retrieve top-ranked ETFs, mutual funds, or companies within a sector.

yfinance_screen read-only

Run predefined or custom equity, fund, and ETF screeners.

Show 7 more tools

yfinance_screen_gappers read-only

Run a custom screener for opening-session bullish gappers.

yfinance_get_price_history read-only

Retrieve historical prices and optionally generate candlestick, VWAP, or volume-profile charts.

yfinance_get_financials read-only

Retrieve annual, quarterly, or TTM income-statement, balance-sheet, and cash-flow data.

yfinance_get_holders read-only

Retrieve major holders, institutional holders, mutual-fund holders, and insider data.

yfinance_get_fund_data read-only

Retrieve ETF or mutual-fund portfolio composition, asset classes, holdings, ratings, and operating details.

yfinance_get_option_dates read-only

Retrieve available option expiration dates for a stock.

yfinance_get_option_chain read-only

Retrieve calls, puts, and strike-price data for available option expirations.

Use cases

Query stock fundamentals, valuation, trading data, and dividends

Retrieve price history and generate technical-analysis charts

Search financial news, stocks, and ETFs

Screen equities, funds, ETFs, or opening-session gappers

Inspect financial statements, analyst views, ownership, and options data

Supported clients

CodexPartial support

Listed from the project's documentation, not tested by this site.

Overview

Yahoo Finance MCP Server gives AI assistants access to Yahoo Finance data through yfinance, including stock information, analyst data, financial statements, news, search, sector rankings, screeners, price history, charts, options, ownership, and fund data. It runs over stdio and can be installed with uvx, Docker, or from source.

Similar servers

Hevy MCP 77 · B

Manage your Hevy workout data from AI assistants via MCP.

★ 517 · Tools 26 Compare with this →

Firecrawl MCP Server 75 · B

Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents

★ 7.6k · Tools 11 Compare with this →

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 659 · Tools 11 Compare with this →

Compartment 75 · B

Encrypted, fully offline long-term memory for AI agents

★ 583 · Tools 14 Compare with this →

Compare with other MCP servers

Source revision 1b7f45febd94 Data synced 2026-10-19 Read the FMRS scoring method