# Benethos Yahoo Finance MCP

> Benethos Yahoo Finance MCP is an open-source MCP server for finance and payments. Unofficial read-only Yahoo Finance data for assistants, via yfinance over stdio or HTTP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/benethos-hub/yahoo-finance-mcp
- **MCP Registry name:** io.github.benethos-hub/benethos-yahoo-finance-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "benethos-yahoo-finance-mcp": {
      "command": "uvx",
      "args": [
        "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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/benethos-yahoo-finance-mcp
