Yahoo Finance (narumiruna) MCP Server [2026]

01 · Install Yahoo Finance (narumiruna)

Claude Code

claude mcp add narumiruna-yfinance-mcp -- uvx yfmcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "narumiruna-yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package yfmcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.narumiruna is GitHub-verified and matches the repo owner

03 · What Yahoo Finance (narumiruna) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can retrieve comprehensive stock data including company info, financials, trading metrics, and governance data, fetch the current price and analyst consensus price targets for a stock, fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history, and fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.

Capability map

Tools grouped from the project's README - what Yahoo Finance (narumiruna) lets an agent do.

Yfinance

15 tools - e.g. Retrieve comprehensive stock data including company info, financials, trading metrics, and governance data.; Fetch the current price and analyst consensus price targets for a stock.; Fetch analyst…

yfinance_get_ticker_info · yfinance_get_analyst_price_targets · yfinance_get_analyst_estimates · yfinance_get_upgrades_downgrades · yfinance_get_ticker_news · yfinance_search…

Insider

3 tools - e.g. Recent insider trades; records typically include fields such as Shares, Value, Insider, Position, Transaction, Start Date, Ownership; Six-month summary where each row describes a category (Purchases…

insider_transactions · insider_purchases · insider_roster

Major

1 tool - e.g. Aggregated breakdown where each row has an index label (e.g. insidersPercentHeld, institutionsPercentHeld, institutionsFloatPercentHeld, institutionsCount) and

major_holders

Institutional

1 tool - e.g. Institutional investors; records typically include fields such as Date Reported, Holder, Shares, Value, pctChange, pctHeld

institutional_holders

Mutualfund

1 tool - e.g. Mutual fund holders; records typically include fields similar to institutional holders

mutualfund_holders

Latest releases

v0.14.0 · 2026-08-05

bump ty from 0.0.63 to 0.0.65 · Add analyst estimates, fund data, and ETF screening

v0.13.0 · 2026-08-02

Add analyst price targets and rating actions · New Contributors · @neusse made their first contribution in

v0.12.4 · 2026-07-30

Fix uvx startup with MCP SDK v2 available

04 · Who maintains Yahoo Finance (narumiruna)

Yahoo Finance is maintained by narumiruna. We track 2 MCP servers from narumiruna - 2 actively maintained, 191 combined GitHub stars, oldest repo from Mar 2025. Full record: all servers from narumiruna.

Legislative Yuan Model Context Protocol server for Taiwan Legislative Yuan API v2. ★ 6

05 · Facts

repository: github.com/narumiruna/yfinance-mcp
website: https://github.com/narumiruna/yfinance-mcp
category: finance - ranked #2 of 283 actively-maintained finance servers as of 2026-08-25.
release cadence: 7 releases in the last 90 days (latest 2026-08-05)
registry: io.github.narumiruna/yfinance-mcp (active, first published 2026-07-30 · 2 versions)
packages: pypi:yfmcp

06 · Yahoo Finance (narumiruna) FAQ

Is Yahoo Finance (narumiruna) still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-23 and it shipped 7 releases in the last 90 days. We re-verify nightly.

What can Yahoo Finance (narumiruna) do?

With this server connected, an agent can retrieve comprehensive stock data including company info, financials, trading metrics, and governance data, fetch the current price and analyst consensus price targets for a stock, fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history, and fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.

How do I install Yahoo Finance (narumiruna)?

Run `uvx yfmcp`. You can also paste the ready-made client config above.

Does Yahoo Finance (narumiruna) run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Yahoo Finance (narumiruna)

Alternatives to Yahoo Finance (narumiruna)

Maintained finance servers if Yahoo Finance (narumiruna) isn't the fit.

Pairs well with

Servers that cover what Yahoo Finance (narumiruna) doesn't - only shown when the pairing reason fits the companion.

head to head · Edgar Tools vs Yahoo Finance (narumiruna) · T2000 vs Yahoo Finance (narumiruna)

More finance MCP servers · Mftool MCP · NEUS MCP · Strat Evo · Fiscal Brasil (nikolasdehor) · Crypto Market Data

More Python MCP servers · Redcon · Nauro · Rebar · Broker · see all