get_companies

Get companies · Free discovery Find SEC-registered U.S. companies and selected verified international listings by symbol or name. Search by market, sector or exchange-qualified symbol, such as Indian banks, Canadian stocks or XTAI:2330. Use the returned selector with get_company_snapshot for available cited issuer facts. Listing identity and released investor research are reported separately. Free.

Input parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of. min length 1; max length 80

Transports

MCP: tools/call with name get_companies at https://beliefstate.ai/mcp (account access) or https://beliefstate.ai/v1/research/mcp (free discovery; no account or payment). See MCP integration.
Public HTTP: GET https://beliefstate.ai/v1/tickers?q=%3Cq%3E. Free discovery; no payment authorization.
Related REST resource: GET /v1/tickers.

Example request

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_companies",
    "arguments": {
      "q": "<q>"
    }
  }
}

The example shows request shape only. Identifiers are placeholders, not records.

Contract version: 2026-11-08. Input parameters and tool metadata come from the shared executable catalog. REST API version: v1.

Get Started

Core Concepts

Guides

Reference

Endpoints

Research tools

Input parameters

Transports

Example request

MCP

​Input parameters

​Transports

​Example request

​MCP

​Related

Input parameters

Transports

Example request

MCP

Related