# stocks_search_tickers Resolve a company name/ticker/fragment to ranked candidate entities. | Field | Value | | --- | --- | | Category | Stocks (`stocks`) | | Exposure | public | | MCP tool | `stocks_search_tickers` | | Documentation | https://www.agentdatasets.com/docs/tools/stocks_search_tickers | ## Description Resolve a company name/ticker/fragment to ranked candidate entities. The result is the shared envelope: `data.query` echoes the search and `data.matches` is the ranked list (best first); `meta` holds `source` and the freshest match `as_of`; `pagination` is null — this is a bounded relevance list, not a paged one, so refine the query for better matches rather than expecting to page. Each match carries `cik`, `name`, `symbol` (the matched or representative active ticker, or null if the company has no active symbol), `exchange`, `symbol_active`, a `score` in [0, 1], and a `match_reason` (`ticker_exact`, `ticker_prefix`, `name_exact`, `name_fuzzy`) so you can see why a candidate ranked where it did. An empty/whitespace query returns no matches (a normal, empty success — not an error). Use this to disambiguate before calling a data tool; once you have a `cik` or exact `ticker`, call `stocks_get_company_facts` for the profile or a statement/price tool for the data. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | query | input | `string` | yes | — | — | Free-form search: a company name ('Berkshire Hathaway'), a ticker ('BRK.B'), or a fragment ('united'). Call this FIRST when you have a name rather than an exact ticker or CIK, then pass a match's `ticker`/`cik` to the other stocks_* tools. | | limit | input | `integer` | no | 10 | min 1, max 50 | Max ranked matches to return (1–50). | ## Provenance - `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: `stocks_ticker_directory`.