MCP tool · Companies

search_companies

Find organisations by name, with optional industry, country and type filters.

Read only

When to use

Use it to get an organisation's reference when you want the company record itself. If you only need a reference to filter events by, resolve_search_terms is quicker. The same company can come back under several name variants; pick the one with the most data.

Parameters

querystring·bodyrequired
Company name or partial name to search for.
limitinteger·body
Max results to return (default 20, max 100) Range 1 to 100.Default 20
industryinteger·body
Filter by industry ID.
countrystring·body
Filter by country — a name ("United Kingdom", "England") or an ISO code (GB, US). Coverage is partial: many companies have no country recorded, so prefer a name search alone when it is enough.
typestring·body
Filter by organisation type.

country takes a name (United Kingdom) or a two-letter code (GB). Many organisations have no country recorded, so a name search on its own is often the better query.

Example

Ask your assistant something like this, and it makes the call below. The result is shown as the JSON the tool returns, which reaches the assistant as a text content item.

Find Halberd Industrial Group.

Example records are invented.

Errors

These come back as a tool result with isError: true, so the assistant can read the reason and try again.

  • Invalid arguments for tool search_companies: …An argument fails the schema, such as a limit above 100.

Built on

The tool calls this endpoint with your own token. Use the API directly to get the same data into your own systems.

Related