`search_companies`

Pack: sec · Endpoint: https://gateway.pipeworx.io/sec/mcp

Search SEC EDGAR for companies by name or ticker symbol. Returns matching company names and their CIK numbers, which are needed for other SEC tools.

Parameters

Name	Type	Required	Description
`query`	string	yes	Company name or ticker to search for (e.g., “Apple”, “TSLA”, “Microsoft”)

Example call

Arguments

{
  "query": "Apple"
}

curl

curl -X POST https://gateway.pipeworx.io/sec/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_companies","arguments":{"query":"Apple"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_companies', {
  "query": "Apple"
});

More examples

{
  "query": "TSLA"
}

Response shape

Always returns: query, total_hits, companies

Field	Type	Description
`query`	string	The search query used
`total_hits`	number	Total number of matching results from SEC EDGAR
`companies`	array	List of matching companies

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query used"
    },
    "total_hits": {
      "type": "number",
      "description": "Total number of matching results from SEC EDGAR"
    },
    "companies": {
      "type": "array",
      "description": "List of matching companies",
      "items": {
        "type": "object",
        "properties": {
          "cik": {
            "type": "string",
            "description": "Company CIK number (entity ID)"
          },
          "name": {
            "type": "string",
            "description": "Company name"
          },
          "category": {
            "type": "string",
            "description": "Company category or type"
          }
        },
        "required": [
          "cik",
          "name",
          "category"
        ]
      }
    }
  },
  "required": [
    "query",
    "total_hits",
    "companies"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "sec": {
      "url": "https://gateway.pipeworx.io/sec/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_companies