Skip to content
MCP server

Benethos Yahoo Finance MCP

Unofficial read-only Yahoo Finance data for assistants, via yfinance over stdio or HTTP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.13.2
Listing updated
3 days ago

About Benethos Yahoo Finance MCP

Benethos Yahoo Finance MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Quotes, price history, financial statements, analyst estimates, holders, ETF holdings, options chains, SEC filings, sector rankings and screeners are all reachable by asking in plain language, and the answer rests on what Yahoo returns rather than the model's memory. It never places orders, holds a portfolio or signs in anywhere.

Data comes through the yfinance library, which uses Yahoo's unofficial endpoints. The README warns they can change or break, that Yahoo may block requests, that data can be delayed or wrong, and that it is intended for personal and educational use; commercial users are pointed to a licensed provider. A symbol-resolution feature maps company names and ISINs to Yahoo tickers.

Six built-in prompts act as recipes with fixed tool order and notes on data pitfalls, including an asset analysis, an earnings preview and a dividend calendar. Run it over stdio for a desktop client, or over HTTP in Docker or Compose for a team front end or an automation such as n8n, with an optional result cache in front of Yahoo.

Install

Run in a terminal

claude mcp add benethos-yahoo-finance-mcp -- uvx benethos-yahoo-finance-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "benethos-yahoo-finance-mcp": {
      "command": "uvx",
      "args": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "benethos-yahoo-finance-mcp": {
      "command": "uvx",
      "args": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "benethos-yahoo-finance-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "benethos-yahoo-finance-mcp": {
      "command": "uvx",
      "args": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "benethos-yahoo-finance-mcp": {
      "command": "uvx",
      "args": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}

What it does

Prices and history
Quotes, 52-week ranges and daily closes for calculations such as RSI or drawdown.
Company fundamentals
Profiles, financial statements, estimates, rating changes, holders and insider trades.
Funds and options
ETF holdings and weightings, option expirations, calls and puts.
Screening and sectors
Finds stocks by dividend yield or P/E and ranks companies within sectors.
Symbol resolution
Resolves company names, exchanges and ISINs to Yahoo tickers.
Optional result cache
Reduces calls to Yahoo when running as a shared HTTP service.

Good for

  • Quick quote and 52-week range lookups in chat
  • Research one company across statements, estimates and ownership
  • Compare tickers or ETFs side by side
  • Preview upcoming earnings and ex-dividend dates
  • Provide market data to an n8n workflow or team web app

Pricing

Open source

Free; intended for personal and educational use

Benethos Yahoo Finance MCP FAQ

Is it read-only?

Yes. It places no orders, holds no portfolio and signs in nowhere.

Is the data reliable enough to trade on?

No. The README says data may be delayed, incomplete or inaccurate and is not financial advice.

Is it from Yahoo?

No. It is unaffiliated and relies on unofficial Yahoo endpoints via yfinance, which may break or be rate limited.

How can I run it?

As a Claude Desktop extension, with uv, in Docker or with Compose; stdio is the default and HTTP is optional.

Is Benethos Yahoo Finance MCP free?

Yes. Benethos Yahoo Finance MCP is open source, so you can use and self-host it for free.

How do I add Benethos Yahoo Finance MCP to Claude Code?

Run this command in your terminal: claude mcp add benethos-yahoo-finance-mcp -- uvx benethos-yahoo-finance-mcp

What are the best alternatives to Benethos Yahoo Finance MCP?

The closest alternatives to Benethos Yahoo Finance MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Benethos Yahoo Finance MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments