stocks_search_tickers
Resolve a company name/ticker/fragment to ranked candidate entities.
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.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | 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 | integer | No | 10 | min 1, max 50 | Max ranked matches to return (1–50). |
Provenance
Sources behind every value this tool returns.
- sec_company_tickersU.S. Securities and Exchange Commission (EDGAR)
Dataset registry: stocks_ticker_directory