io.github.benethos-hub/benethos-yahoo-finance-mcp
PYPI · BENETHOS-YAHOO-FINANCE-MCP · 3 COMPONENTS
Unofficial read-only MCP server exposing Yahoo Finance data (via yfinance) over stdio or HTTP.
Last scanned (13 hours ago)
Scores higher than 69% of PyPI servers
Category Finance and Payments
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. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 2 of 50 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 4 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability71
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 23 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 24 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
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.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 14 Oct 26 +30
- Provenance: fail → unverified ▼ security
- 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). security
- Tool coverage: unverified → 100 ▲ functional
- 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 functional
- 12 Oct 26 40
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 18 Oct 2026 · Analysed pypi/benethos-yahoo-finance-mcp@0.8.6
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
| Reason | No attestation published |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 50 packages
| Packages resolved | 50 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
get_calendar Corporate calendar ~104
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.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_company_info Company profile ~126
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.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_dividends Dividends and splits ~67
Get the dividend and stock-split history for a Yahoo symbol.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_earnings Earnings ~122
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of earnings rows to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_estimates Analyst estimates ~104
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.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_financials Financial statements ~146
Get a financial statement for a Yahoo symbol. Each row is a line item and each column a reporting period, most recent first.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_fund_data Fund profile ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of top holdings to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_history Price history ~311
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_holders Holders ~125
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of institutional/mutual-fund holders to return per list. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_industry Industry ~141
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.
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | yes | 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. |
Structured output declared, but exposes no named fields.
No examples provided.
get_insider_activity Insider activity ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of insider transactions/roster rows to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_market Market status ~195
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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… |
Structured output declared, but exposes no named fields.
No examples provided.
get_news News ~99
Get recent news headlines for a Yahoo symbol (up to `limit`, 1-10). Each article includes title, summary, publisher, publish time, and URL.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of headlines to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_options Option chain ~180
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.
| Name | Type | Req | Description |
|---|---|---|---|
| expiration | – | – | Expiration date 'YYYY-MM-DD' from the list returned when called without it. Omit to list available expiration dates. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_quote Quote ~66
Get the current price and key intraday figures for a Yahoo symbol.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_quotes Quotes for several symbols ~139
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.
| Name | Type | Req | Description |
|---|---|---|---|
| symbols | array | yes | Yahoo tickers or ISINs, e.g. ['AAPL', 'MSFT', 'SAP.DE']. Not company names. Up to 50, extras are dropped. |
Structured output declared, but exposes no named fields.
No examples provided.
get_recommendations Analyst recommendations ~92
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.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_sec_filings SEC filings ~154
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of filings to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_sector Sector ~170
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.
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | yes | 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. |
Structured output declared, but exposes no named fields.
No examples provided.
get_shares Shares outstanding ~171
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
get_upgrades_downgrades Rating changes ~128
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of rating changes to return. |
| symbol | string | yes | A Yahoo ticker or an ISIN, e.g. 'AAPL', 'SAP.DE' or 'US0378331005'. For a company name, use 'search' first. |
Structured output declared, but exposes no named fields.
No examples provided.
screen Stock screener ~501
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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | array | yes | 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. |
Structured output declared, but exposes no named fields.
No examples provided.
search Search instruments ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of matches to return. |
| query | string | yes | Company name, ticker symbol, or ISIN to look up. |
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
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.
pypi · benethos-yahoo-finance-mcp
claude mcp add benethos-hub-benethos-yahoo-finance-mcp -- uvx benethos-yahoo-finance-mcp
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.