What inputs does search_companies accept?

query (string, optional): Free-text search over company name and ticker. Case-insensitive. E.g. 'Apple', 'AAPL', 'Microsoft', 'semiconductor'. cik (string, optional): SEC CIK identifier (exact match). E.g. '0000320193' for Apple. sic_code (string, optional): 4-digit SIC industry code. E.g. '7372' for Prepackaged Software. is_active (boolean, optional): Filter on whether the LISTING is current. true = currently trading; false = superseded listings only (delisted, or a ticker that moved to a new registrant). Omit to return both. is_sp500 (boolean, optional): Filter to current S&P 500 members only. include_inactive (boolean, optional, default true): Whether delisted / superseded listings may appear in results. Defaults to true — this is a survivorship-free product, so a search must not silently hide dead companies by default. Set to false to restrict to currently-active listings only (equivalent to `is_active: true`, but as a search-scope toggle rather than a hard filter). If `is_active` is also supplied, `is_active` wins. limit (integer, optional, default 25): Maximum number of results to return (1–50). Defaults to 25.

Which Valuein plans include search_companies?

Available on every plan, including the free tier with no account. Not point-in-time safe.

Discovery

Search Companies

search_companies

Sample and above

Search for US public companies by name, ticker symbol, CIK (SEC identifier), or SIC industry code. Returns ticker, company name, sector, industry, exchange, and current S&P 500 membership status. Use this tool to resolve a company name to ticker/CIK before calling `get_company...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "search_companies",    arguments={})print(result)

Direct tool call:search_companies(query="Apple")

Try it now

No token required

Paste this in your terminal — the free tier returns real sample data without authentication.

try-it.shbash

# No auth required — the Sample tier covers a large-cap US benchmark universe with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \    -H "Content-Type: application/json" \    -H "Accept: application/json, text/event-stream" \    -d '{        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {          "name": "search_companies",          "arguments": {            "limit": 3,            "query": "Apple"          }        }      }'

Inputs

Parameter	Type	Required	Description
`query`	string	optional	Free-text search over company name and ticker. Case-insensitive. E.g. 'Apple', 'AAPL', 'Microsoft', 'semiconductor'.
`cik`	string	optional	SEC CIK identifier (exact match). E.g. '0000320193' for Apple.
`sic_code`	string	optional	4-digit SIC industry code. E.g. '7372' for Prepackaged Software.
`is_active`	boolean	optional	Filter on whether the LISTING is current. true = currently trading; false = superseded listings only (delisted, or a ticker that moved to a new registrant). Omit to return both.
`is_sp500`	boolean	optional	Filter to current S&P 500 members only.
`include_inactive`	boolean	optional	Whether delisted / superseded listings may appear in results. Defaults to true — this is a survivorship-free product, so a search must not silently hide dead companies by default. Set to false to restrict to currently-active listings only (equivalent to `is_active: true`, but as a search-scope toggle rather than a hard filter). If `is_active` is also supplied, `is_active` wins.Default: `true`
`limit`	integer	optional	Maximum number of results to return (1–50). Defaults to 25.Default: `25`

Output Fields

queryresults_returnedcompanies

Example Response

Illustrative

response.jsonjson

[  {    "query": null,    "results_returned": null,    "companies": null  }]

Shape only — field names match the live schema; values are placeholders, not real filings. Returns Apple Inc. (AAPL, CIK 0000320193) in the Technology sector.

Notes

Available on every plan, including the Sample plan without a token. Results are filtered to the caller's plan universe — the Sample plan returns S&P 500 companies only.