# io.github.benethos-hub/benethos-yahoo-finance-mcp (pypi · benethos-yahoo-finance-mcp)

Unofficial read-only MCP server exposing Yahoo Finance data (via yfinance) over stdio or HTTP.

- Trust score: 70/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-18

## Components

- mcpb · `benethos-yahoo-finance-mcp-0.8.6.mcpb`: 13/100, [markdown](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp-2.md), [page](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp-2)
- oci · `ghcr.io/benethos-hub/benethos-yahoo-finance-mcp`: 42/100, [markdown](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/ghcr-io-benethos-hub-benethos-yahoo-finance-mcp.md), [page](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/ghcr-io-benethos-hub-benethos-yahoo-finance-mcp)
- pypi · `benethos-yahoo-finance-mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp.md), [page](https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp)

## Channel facts

- Registry: `pypi`
- Package: `benethos-yahoo-finance-mcp`
- Version: `0.8.6`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-18.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 2 of 50 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3965 tokens (~172/item across 23 items; 23 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 23 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 24 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the io.github.benethos-hub/benethos-yahoo-finance-mcp server?

io.github.benethos-hub/benethos-yahoo-finance-mcp runs locally as a PyPI package, launched with uvx benethos-yahoo-finance-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add benethos-hub-benethos-yahoo-finance-mcp -- uvx benethos-yahoo-finance-mcp
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add benethos-hub-benethos-yahoo-finance-mcp -- uvx benethos-yahoo-finance-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "benethos-hub-benethos-yahoo-finance-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "benethos-yahoo-finance-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add benethos-hub-benethos-yahoo-finance-mcp --command uvx --arg benethos-yahoo-finance-mcp
```

### Hermes

```yaml
mcp_servers:
  benethos-hub-benethos-yahoo-finance-mcp:
    command: "uvx"
    args: ["benethos-yahoo-finance-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "benethos-hub-benethos-yahoo-finance-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "benethos-yahoo-finance-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add benethos-hub-benethos-yahoo-finance-mcp -t stdio -c uvx -a benethos-yahoo-finance-mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-14 (score 70, +30)

- [security regression] Provenance: fail → unverified
- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] Package version: 0.8.5 → 0.8.6

### 2026-10-12 (score 40)

First indexed and scored.

## MCP tools (23)

### `search` (~110 tokens)

Search instruments

Search Yahoo Finance by company name, ticker symbol, or ISIN.

Use this to turn a company name into a Yahoo `symbol` that the other
tools accept. They take an ISIN directly. Returns up to `limit` matches
(1-25), each with its symbol, name, exchange, instrument type, sector and
industry.

Input parameters:

- `limit` (integer): Maximum number of matches to return.
- `query` (string, required): Company name, ticker symbol, or ISIN to look up.

Output parameters:

- `result` (array)

### `get_quote` (~66 tokens)

Quote

Get the current price and key intraday figures for a Yahoo symbol.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_quotes` (~139 tokens)

Quotes for several symbols

Get compact current quotes for several Yahoo symbols in one call.

Use this to compare or fetch prices for multiple tickers at once. Each symbol
is looked up individually and returns currency, last price, previous close,
open, day high/low, and market cap. Symbols that return no data are listed
under `not_found` rather than failing the whole call, and `truncated`
is set when more than 50 were passed.

Input parameters:

- `symbols` (array, required): Yahoo tickers or ISINs, e.g. ['AAPL', 'MSFT', 'SAP.DE']. Not company names. Up to 50, extras are dropped.

### `get_history` (~311 tokens)

Price history

Get historical OHLCV (open/high/low/close/volume) data for a symbol.

Query a look-back `period` or an explicit `start`/`end` range. Results
are capped at the most recent 250 rows, with `truncated` set when cut.

Input parameters:

- `end`: End date 'YYYY-MM-DD', exclusive: for one day pass the day after. Used only together with 'start'.
- `interval` (string): Bar size. One of: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 4h, 1d, 5d, 1wk, 1mo, 3mo. Intraday intervals only cover recent dates.
- `period` (string): Look-back window: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max, or any count of d, wk, mo or y such as 7mo. Ignored when 'start' is given.
- `start`: Start date 'YYYY-MM-DD'. Overrides 'period' when set.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_company_info` (~126 tokens)

Company profile

Get a company profile and key statistics for a Yahoo symbol.

Returns name, sector/industry, location, employee count, and valuation
metrics (market cap, trailing and forward P/E, P/B, beta, 52-week range,
dividend yield) plus a business summary. For an ISIN, `resolved_symbol`
names the ticker it stands for.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_financials` (~146 tokens)

Financial statements

Get a financial statement for a Yahoo symbol.

Each row is a line item and each column a reporting period, most recent
first.

Input parameters:

- `freq` (string): Reporting frequency: 'annual', 'quarterly', or 'ttm' (trailing twelve months, income and cashflow only).
- `statement` (string): Which statement: 'income' (income statement), 'balance' (balance sheet), or 'cashflow' (cash flow).
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_dividends` (~67 tokens)

Dividends and splits

Get the dividend and stock-split history for a Yahoo symbol.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_news` (~99 tokens)

News

Get recent news headlines for a Yahoo symbol (up to `limit`, 1-10).

Each article includes title, summary, publisher, publish time, and URL.

Input parameters:

- `limit` (integer): Maximum number of headlines to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_calendar` (~104 tokens)

Corporate calendar

Get upcoming corporate-calendar events for a Yahoo symbol.

Returns the next earnings date(s) with analyst estimate ranges and the next
dividend / ex-dividend dates. Equity-only: an ETF, fund or crypto symbol
answers with an error that says so.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_shares` (~171 tokens)

Shares outstanding

Get the shares-outstanding history for a Yahoo symbol.

Each point is a date and the reported shares outstanding. Only the most
recent `limit` points are returned. Without `start` the series covers
the last 18 months, so pass one for anything older.

Input parameters:

- `end`: End date 'YYYY-MM-DD' to bound the series (optional), after 'start'.
- `limit` (integer): Maximum number of (most recent) data points to return.
- `start`: Start date 'YYYY-MM-DD'. Without it the series covers the last 18 months only.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_recommendations` (~92 tokens)

Analyst recommendations

Get analyst recommendation trends and price targets for a Yahoo symbol.

Returns the buy/hold/sell trend over recent months plus current/high/low/
mean/median analyst price targets when available.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_earnings` (~122 tokens)

Earnings

Get upcoming and historical earnings for a Yahoo symbol.

Returns the earnings calendar (upcoming and past dates with EPS estimate,
reported EPS, and surprise %) plus the recent earnings history. Equity-only:
an ETF, fund or crypto symbol answers with an error that says so.

Input parameters:

- `limit` (integer): Maximum number of earnings rows to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_estimates` (~104 tokens)

Analyst estimates

Get forward analyst estimates for a Yahoo symbol.

Returns earnings and revenue estimates, EPS trend and revisions, and growth
estimates (small tables keyed by period). Equity-only: an ETF, fund or
crypto symbol answers with an error that says so.

Input parameters:

- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_upgrades_downgrades` (~128 tokens)

Rating changes

Get recent analyst rating changes (upgrades/downgrades) for a Yahoo symbol.

Each entry is a firm's rating change with the from/to grade and action, most
recent first. Equity-only: an ETF, fund or crypto symbol answers with an
error that says so.

Input parameters:

- `limit` (integer): Maximum number of rating changes to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_holders` (~125 tokens)

Holders

Get the ownership breakdown for a Yahoo symbol.

Returns the high-level holder summary (insider/institutional percentages)
plus the top institutional and mutual-fund holders. Equity-only: an ETF,
fund or crypto symbol answers with an error that says so.

Input parameters:

- `limit` (integer): Maximum number of institutional/mutual-fund holders to return per list.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_insider_activity` (~120 tokens)

Insider activity

Get insider trading activity for a Yahoo symbol.

Returns individual insider transactions, a 6-month purchases/sales summary,
and the current insider roster. Equity-only: an ETF, fund or crypto symbol
answers with an error that says so.

Input parameters:

- `limit` (integer): Maximum number of insider transactions/roster rows to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_sec_filings` (~154 tokens)

SEC filings

Get recent SEC filings for a Yahoo symbol.

Each entry has the filing date, type (e.g. `10-K`, `10-Q`, `8-K`),
title, the Yahoo EDGAR URL, and exhibit links. Only issuers registered with
the U.S. SEC file there, so a non-US symbol has none, and neither do ETFs,
funds or crypto. An empty result says nothing about the symbol.

Input parameters:

- `limit` (integer): Maximum number of filings to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_options` (~180 tokens)

Option chain

Get the option chain for a Yahoo symbol.

Call without `expiration` to list available expiration dates. Call with
an `expiration` (`YYYY-MM-DD` from that list) to get the calls and puts
for that date, up to 60 strikes each centred on the current price, with
\`truncated` set when a wider chain was cut. Yahoo carries chains for
US-listed instruments only, so a non-US symbol has none and that says
nothing about the symbol.

Input parameters:

- `expiration`: Expiration date 'YYYY-MM-DD' from the list returned when called without it. Omit to list available expiration dates.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_fund_data` (~116 tokens)

Fund profile

Get fund/ETF profile data for a Yahoo symbol.

Returns the fund overview, asset-class and sector weightings, and the top
holdings. Fund/ETF-only, raises for stocks and crypto, which have no fund
data.

Input parameters:

- `limit` (integer): Maximum number of top holdings to return.
- `symbol` (string, required): A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first.

### `get_sector` (~170 tokens)

Sector

Browse a market sector by its Yahoo key (not a ticker symbol).

Returns the sector overview (company count, market cap/weight, description),
its top companies, ETFs, and mutual funds, and the constituent industries.
Each industry's `key` can be passed to `get_industry` to drill down,
or to `screen` as its `industry` filter.
This takes a sector key like `technology` or `healthcare` — not a ticker.

Input parameters:

- `key` (string, required): A Yahoo sector key (lowercase, hyphenated). One of: basic-materials, communication-services, consumer-cyclical, consumer-defensive, energy, financial-services, healthcare, industrials, real-estate, t…
- `limit` (integer): Maximum number of top companies to return.

### `get_industry` (~141 tokens)

Industry

Browse an industry by its Yahoo key (not a ticker symbol).

Returns the industry overview, its parent sector, top companies, and the
top-performing and top-growth companies. Discover valid industry keys from
the `industries` list returned by `get_sector`. This takes an industry
key like `semiconductors` — not a ticker symbol.

Input parameters:

- `key` (string, required): A Yahoo industry key (lowercase, hyphenated), e.g. 'semiconductors' or 'software-infrastructure'. Discover valid keys from the 'industries' list returned by get_sector.
- `limit` (integer): Maximum number of top companies to return.

### `get_market` (~195 tokens)

Market status

Get the trading status and headline index summary for a market.

Answers questions like whether the market is open, when it opens or closes
next, and how the major indices are doing. Takes a market key such as
\`US` or `EUROPE` — not a ticker symbol. `status` (open/closed plus the
next open and close times) is only available for `US` and is `null` for
every other key, which is an upstream limitation rather than an error. The
index summary, with price, previous close and change, works for all keys.

Input parameters:

- `key` (string): A Yahoo market key (uppercase). One of: US, GB, ASIA, EUROPE, RATES, COMMODITIES, CURRENCIES, CRYPTOCURRENCIES. Only 'US' reports a trading status, the others return the index summary with 'status' s…

### `screen` (~501 tokens)

Stock screener

Find stocks by criteria, e.g. dividend payers in a region or cheap large caps.

Fields are these aliases, or a raw Yahoo screener field name:
\- market: market_cap, price, change_percent, change_52w_percent, volume,
  avg_volume_3m, beta
\- valuation: pe_ratio, peg_ratio, price_to_book, price_to_sales, ev_to_ebitda
\- dividend: dividend_yield, forward_dividend_yield, dividend_growth_years
\- profitability and growth: return_on_equity, return_on_assets, net_margin,
  revenue, revenue_growth, eps_growth
\- balance sheet: debt_to_equity, current_ratio
\- ownership: insider_percent, institutional_percent, short_percent_of_float
\- esg_score
\- categories, eq or is-in only: region (country code, 'us', 'de'), exchange
  (Yahoo code, 'NMS', 'GER'), sector ('Technology'), industry (a key or
  name from get_sector)

Percentages are in percent, 3 means 3 %. A loss makes pe_ratio negative,
so pair lt with gt 0. region is where a stock is listed, not where the
company sits, so 'de' includes foreign companies traded in Germany, and a
company appears once per listing. Preferred shares are listings too (on
US exchanges symbols like JPM-PD), carrying the common stock's eps and
market cap, so their pe_ratio means nothing. Returns total (all matches)
and one row per match with price, valuation and dividend figures. A row's
dividend_yield can be missing or differ markedly from the filter, which
holds for Yahoo's screener data, not for that column. The other filters'
figures are not in the rows: get_company_info adds beta and forward P/E,
get_holders the ownership shares, get_financials the statements behind
margins, growth and debt.

Input parameters:

- `filters` (array, required): Conditions that must all hold, e.g. [{"field": "dividend_yield", "op": "gt", "value": 3}].
- `limit` (integer): Maximum number of matches to return.
- `offset` (integer): Matches to skip, for the next page.
- `sort_by` (string): A numeric field or alias to sort by.
- `sort_desc` (boolean): Largest first.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp#diagnostics

## Score history

- 2026-10-18: 70
- 2026-10-17: 70
- 2026-10-16: 70
- 2026-10-15: 70
- 2026-10-14: 70
- 2026-10-13: 40
- 2026-10-12: 40

## Common questions

### What is the io.github.benethos-hub/benethos-yahoo-finance-mcp server?

io.github.benethos-hub/benethos-yahoo-finance-mcp is listed in the public MCP registry as io.github.benethos-hub/benethos-yahoo-finance-mcp. Unofficial read-only MCP server exposing Yahoo Finance data (via yfinance) over stdio or HTTP. This page covers its PyPI package (benethos-yahoo-finance-mcp).

### Is the io.github.benethos-hub/benethos-yahoo-finance-mcp server safe to use?

io.github.benethos-hub/benethos-yahoo-finance-mcp scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 18 October 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.benethos-hub/benethos-yahoo-finance-mcp server expose?

io.github.benethos-hub/benethos-yahoo-finance-mcp exposes 23 tools: search, get_quote, get_quotes, get_history, get_company_info, and 18 more. Their descriptions and schemas cost roughly 3,487 tokens of context every time the server is loaded.

### Is the io.github.benethos-hub/benethos-yahoo-finance-mcp server still maintained?

io.github.benethos-hub/benethos-yahoo-finance-mcp is still listed as active in the MCP registry. We last reached this channel on 18 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.benethos-hub/benethos-yahoo-finance-mcp server under?

io.github.benethos-hub/benethos-yahoo-finance-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/benethos-yahoo-finance-mcp/
- Socket report: https://socket.dev/pypi/package/benethos-yahoo-finance-mcp
- Repository: https://github.com/benethos-hub/yahoo-finance-mcp
- Changelog RSS feed: https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp.json
- HTML version of this page: https://verifymcp.io/servers/benethos-hub-benethos-yahoo-finance-mcp/benethos-yahoo-finance-mcp