What inputs does search_companies accept?

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.

Which Valuein plans include search_companies?

Available on: sample, sp500, full. Not point-in-time safe.

Discovery

Search Companies

search_companies

Free

Pro · Institutional

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

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={
    "query": "EXAMPLE"
}
)
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 S&P500 data without authentication.

try-it.shbash

# No auth required — sample tier covers S&P500 with a 5-year window.
# Add an Authorization: Bearer header for full universe and history.
$ curl -X POST https://mcp.valuein.biz/mcp \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "search_companies",
          "arguments": {
            "query": "Apple",
            "limit": 3
          }
        }
      }'

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

Illustrative

response.jsonjson

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

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