Search Companies

search_companies

sample

sp500

full

Search for companies by name, ticker symbol, or CIK. Returns company metadata including sector, industry, SIC code, and S&P 500 membership. Use this tool first to resolve a company name to a ticker or CIK before querying financial data.

Example Call

# 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={
    "query": "EXAMPLE"
}
)
print(result)

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

Inputs

Parameter	Type	Required	Description
`query`	string	required	Company name, ticker symbol, or CIK. Partial matches are supported for names.
`limit`	integer	optional	Maximum results to return (1–50). Defaults to 10.

Output Fields

ciktickernamesectorindustrysic_codeexchangestatusis_sp500

Example Response

[
  {
    "cik": "0000320193",
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "sic_code": "3674",
    "exchange": "NASDAQ",
    "status": "ACTIVE"
  }
]