<!-- Agent Datasets docs · stocks_get_fund_holders · canonical: https://www.agentdatasets.com/docs/tools/stocks_get_fund_holders · rendered from https://www.agentdatasets.com -->

# stocks_get_fund_holders

Registered funds whose latest Form N-PORT filing holds a company.

| Field | Value |
| --- | --- |
| Category | Stocks (`stocks`) |
| Exposure | public |
| MCP tool | `stocks_get_fund_holders` |
| Documentation | https://www.agentdatasets.com/docs/tools/stocks_get_fund_holders |

## Description

Registered funds whose latest Form N-PORT filing holds a company.

Returns the shared envelope. `data` echoes subject identity (`ticker`,
`cik`, `company_name`), and `data.holders` contains one aggregate row per
fund series, ordered by summed `pct_value` (% of the fund's net assets)
descending. Each holder includes `value_usd`, `holdings_count`,
report-period and filing lineage, and fund identity.

Coverage: results reflect the ingested pilot universe of registered
funds' latest N-PORT filings — not the whole market. Matching uses the
filed ticker (validity-checked against the company's registered symbols)
or exact-normalized issuer name (only when the name is unambiguous among
covered companies). `meta.unattributed_holdings` reports rows attributable
by neither leg. LEI matching is deferred until a company↔LEI crosswalk
exists (#230).

This is latest-period-only: an amendment supersedes the original and
each fund contributes only its newest report period. Use
`funds_get_holdings` with `report_period` to inspect a fund's historical
snapshots. A valid ticker with no covered holders returns a successful
empty page, not an error.

Bounds: default 25, max 100 funds per page; page via
`pagination.next_cursor` → `cursor`. Errors carry machine codes:
`unknown_entity` (with did-you-mean suggestions) for an unknown ticker
and `bad_parameter` for a malformed ticker, limit, or cursor.

Example: `stocks_get_fund_holders(ticker="AAPL", limit=10)`.

## Parameters

Input schema advertised to MCP clients and mirrored by the REST query string.

| Parameter | In | Type | Required | Default | Constraints | Description |
| --- | --- | --- | --- | --- | --- | --- |
| ticker | input | `string` | yes | — | min length 1 | A US public company by ticker symbol ('AAPL', 'BRK.B'). Use this to see which covered registered funds hold the company in their latest Form N-PORT filing. |
| limit | input | `integer` | no | 25 | min 1, max 100 | Fund holders to return, highest portfolio weight first (1-100). |
| cursor | input | `string \| null` | no | null | — | Opaque pagination cursor from a previous response's `pagination.next_cursor`; omit to start with the highest weight. |

## Provenance

- `sec-edgar-archives` — U.S. Securities and Exchange Commission (EDGAR), Section text extracted from 10-K/10-Q primary documents on sec.gov Archives (canonical Items with accession-number and source-URL lineage); full document HTML is never stored (U.S. Government work, public domain (17 U.S.C. § 105)). See https://www.agentdatasets.com/docs/attribution.md
- `sec_company_tickers` — U.S. Securities and Exchange Commission (EDGAR), Company-ticker-CIK mapping with listing exchange (`company_tickers.json`, `company_tickers_exchange.json`) (U.S. Government work, public domain (17 U.S.C. § 105)). See https://www.agentdatasets.com/docs/attribution.md

Dataset registry: `funds_nport_holdings`.
