Search companies
search_companiesSearch national company registries by name or keyword across multiple countries. Filter results with country-specific fields like postal code or registration number.
Instructions
Search a national company registry by name or keyword. Pass EXACTLY ONE of:
• jurisdiction='GB' - single country, direct.
• jurisdictions=['GB','NO','FR'] - multi-country when you're unsure; the server asks the user to confirm (clients with MCP elicitation) or errors back asking you to ask in chat. Per-tier cap on distinct countries per call: anonymous=3, pro=10, max=30, enterprise=unlimited.
Returns candidates with unified fields (company_id, company_name, status, incorporation_date, registered_address) plus raw upstream jurisdiction_data. For country-specific filters (FR ca_min, CZ czNace, CH canton, etc.) pass the filters object — call list_jurisdictions for the per-country schema.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jurisdiction | No | ISO 3166-1 alpha-2 country code (uppercase; CA subdivisions hyphenated, e.g. 'CA-BC'). Use this when one country is known. Mutually exclusive with `jurisdictions`. | |
| jurisdictions | No | Array of ISO codes when the country is uncertain. The server asks the user to confirm the list (clients with MCP elicitation) or returns an error so you can ask in chat. Mutually exclusive with `jurisdiction`. | |
| query | No | Company name or keyword. May be empty for FR / IE when searching purely by structured `filters`. AU also accepts structured `key:value` pairs in this field (e.g. 'postcode:2000 type:PUB active:Y'). | |
| limit | No | Max candidates to return (1-250). Default 10. | |
| offset | No | Pagination offset (IE / FR). | |
| filters | No | Country-specific advanced filters. Flat object keyed by the upstream field name (e.g. FR `code_postal` / `ca_min`, CZ `czNace`, CH `canton`, FI `companyForm`, IE `alpha`, IS `vat_number`). Call `list_jurisdictions({jurisdiction:'<CC>'})` for the per-country schema. | |
| fresh | No | Bypass cache; call upstream directly. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queried_at | Yes | ISO-8601 + Europe/London timezone stamp for when the registry was queried. | |
| jurisdiction | No | Single-country mode. | |
| jurisdictions | No | Multi-country fan-out mode. | |
| query | No | ||
| count | No | ||
| cached_at | No | ||
| results | No | Candidate list (single-country key). | |
| candidates | No | Candidate list (multi-country fan-out key). | |
| per_jurisdiction | No | ||
| partial_failures | No |