Search companies

Removed value: -{
-  "description": "CH only. If true, returns only ACTIVE companies (excludes CANCELLED and BEING_CANCELLED).",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR / FR-near-point only. NAF/APE industry code (e.g. '64.20Z').",
-  "type": "string"
-}

Removed value: -{
-  "description": "Registered-address substring filter. IE: free-text substring of the company address. IS: prefix of the 'heimili' field on Skatturinn's /leit form (upstream accepts a single word or street prefix; Icelandic-dative form when searching by street name).",
-  "type": "string"
-}

Removed value: -{
-  "description": "IE only. Alphabetic prefix filter on the company name.",
-  "type": "string"
-}

Removed value: -{
-  "description": "IE only. Which CRO register to search: 'C' = companies (default), 'B' = business names, 'E' = both (slowest).",
-  "enum": [
-    "C",
-    "B",
-    "E"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Maximum chiffre d'affaires (revenue) in EUR.",
-  "type": "number"
-}

Removed value: -{
-  "description": "FR only. Minimum chiffre d'affaires (revenue) in EUR.",
-  "type": "number"
-}

Removed value: -{
-  "description": "CH only. 2-letter canton abbreviation (ZH / BE / GE / VD / VS / TI / ...). Mutually exclusive with registryOfCommerceId or legalSeatId.",
-  "maxLength": 2,
-  "minLength": 2,
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Company size category.",
-  "enum": [
-    "PME",
-    "ETI",
-    "GE"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. INSEE commune code.",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. 5-digit French postal code (e.g. '75001'). Note: filters companies whose ANY establishment is at this postcode — the company's siège social may be elsewhere. Check `jurisdiction_data.matching_etablissements` to see which establishment matched.",
-  "type": "string"
-}

Removed value: -{
-  "description": "FI only. Company form code: OYJ (public Ltd), OY (private Ltd), KY (limited partnership), AY (partnership), OK (cooperative), SÄÄ (foundation), AOY (housing company), etc.",
-  "type": "string"
-}

Removed value: -{
-  "anyOf": [
-    {
-      "pattern": "^([0-9]{5}|[A-U])$",
-      "type": "string"
-    },
-    {
-      "items": {
-        "pattern": "^([0-9]{5}|[A-U])$",
-        "type": "string"
-      },
-      "type": "array"
-    }
-  ],
-  "description": "CZ only. NACE industry code(s). ARES requires 5-DIGIT or single-LETTER form: 5 digits for sub-class (e.g. '62010' programming), single letter A-U for the section (e.g. 'G' wholesale & retail). 4-digit (class) or 2-digit (division) values are rejected by zod — they would otherwise silently return 0 results from ARES. Filtering by section alone usually exceeds the >1000 cap; combine with another filter."
-}

Removed value: -{
-  "description": "FR only. Maximum birth date of a person (YYYY-MM-DD).",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Minimum birth date of a person (YYYY-MM-DD).",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. 2-3 digit department code (e.g. '75', '971').",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. EPCI (intermunicipal grouping) SIREN.",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Only entities registered as associations (RNA).",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only Agence Bio certified establishments.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only territorial collectivities.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only sole traders.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only social/solidarity-economy entities.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only training organisations.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only Qualiopi-certified training organisations.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only RGE (environmental) certified.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only public-service entities.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. Only mission-driven companies.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "FR only. 'A'=active, 'C'=ceased. Note: the establishment-level 'F'=Fermé state appears in the data but is NOT a valid filter value upstream — use 'C' for closed entities.",
-  "enum": [
-    "A",
-    "C"
-  ],
-  "type": "string"
-}

Added value: +{
+  "additionalProperties": {},
+  "description": "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.",
+  "type": "object"
+}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  ],
-  "description": "CZ only. Tax-office code(s) — see FinancniUrad code-list."
-}

Removed value: -{
-  "description": "IS only. When true, treats the query as a plain name search even if it happens to be a 10-digit string (otherwise the adapter treats 10 digits as a kennitala direct-lookup).",
-  "type": "boolean"
-}

Previous value: -"Bypass the search cache and call upstream registries directly. Default false."New value: +"Bypass cache; call upstream directly."

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  ],
-  "description": "CZ only. One or more exact IČO values to look up."
-}

Removed value: -{
-  "description": "IE only. Convenience flag — when true, sets bus_ind='E' to search both registers.",
-  "type": "boolean"
-}

Previous value: -"EXACTLY ONE of `jurisdiction` or `jurisdictions` must be provided. Use `jurisdiction` (singular) when the user has clearly specified ONE country — a direct lookup, no confirmation screen shown. ISO 3166-1 alpha-2 country code. Supported values: 'GB', 'NO', 'AU', 'IE', 'FR', 'FI', 'CZ', 'PL', 'CA', 'CA-BC', 'CA-NT', 'BE', 'IM', 'IS', 'CY', 'CH', 'TW', 'LI', 'DE', 'NZ', 'NL', 'MC', 'IT', 'RU'. Use the exact uppercase code (ISO-3166-2 hyphenated form for CA subdivisions)."New value: +"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`."

Previous value: -"EXACTLY ONE of `jurisdiction` or `jurisdictions` must be provided. Use `jurisdictions` (plural) when you are UNCERTAIN which country the company is in and want to search multiple candidates. Pass an array of 2–N ISO codes representing your best guesses based on company name / domain / user hints. The server will SHOW THE USER your picks in a confirmation dialog (on clients that support it — Claude Desktop, Claude Code, Cursor, and new Gemini CLI) and let them edit before running any search. On clients without that support, the call returns an error telling you to ask the user in chat. Per-tier caps on how many countries can be searched in one call: anonymous/free=3, pro=10, max=30, enterprise=unlimited. If you pass more than the user's cap, the confirmation form will trim to the cap."New value: +"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`."

Removed value: -{
-  "description": "CH only. Internal legal-form ID (1-999). Use get_code_description(CH, legalForm) to discover codes. Example: 9 = Aktiengesellschaft (AG).",
-  "maximum": 999,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "CH only. Public legal-form code per eCH-0097 data standard (4 chars). Example: '0106' = AG, '0108' = Sàrl. Alternative to legalFormId.",
-  "maxLength": 4,
-  "minLength": 4,
-  "type": "string"
-}

Removed value: -{
-  "description": "CH only. BFS commune number of the legal seat. Use get_code_description(CH, community) to discover. Example: 261 = Zurich city. Mutually exclusive with registryOfCommerceId or canton.",
-  "type": "integer"
-}

Previous value: -"Maximum candidates to return (1-250). Default 10. Per-jurisdiction upstream caps: GB 100, NO 1000, AU 200, IE 250."New value: +"Max candidates to return (1-250). Default 10."

Removed value: -{
-  "description": "FI only. Town or city name (any of FI/SV/EN names match).",
-  "type": "string"
-}

Removed value: -{
-  "description": "FI only. Statistics Finland TOL 2008 industry code (e.g. '6201') or text.",
-  "type": "string"
-}

Removed value: -{
-  "description": "IE only. Match strategy for the company_name parameter. 'exact' is fastest (~300ms), 'starts_with' moderate, 'contains' slowest (~3s) — default contains.",
-  "enum": [
-    "exact",
-    "starts_with",
-    "contains"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Legal-form code (INSEE).",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Surname of a dirigeant or elected official to filter by.",
-  "type": "string"
-}

Previous value: -"IE / FR only. Skip the first N results (pagination). CRO caps each page at 250; FR at 25. Combine with limit to walk large result sets."New value: +"Pagination offset (IE / FR)."

Removed value: -{
-  "description": "FI only. Page number (1-indexed). PRH paginates with `page` not offset.",
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "FI only. 5-digit Finnish postcode.",
-  "type": "string"
-}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  ],
-  "description": "CZ only. Legal-form code(s) — see PravniForma code-list (e.g. '112'=s.r.o./LLC, '121'=a.s./joint-stock, '100'=sole trader). Use get_code_description for the full list."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    }
-  ],
-  "description": "CZ only. Legal-form code(s) from the ROS public-registers source — usually equivalent to pravniForma."
-}

Removed value: -{
-  "description": "FR only. Given name(s) of a dirigeant/elected official.",
-  "type": "string"
-}

Previous value: -"Company name or keyword. May be EMPTY for FR/IE when you're searching purely by structured filters (e.g. code_postal + ca_min for FR; address + alpha for IE). For AU only, also accepts structured filter syntax: space-separated key:value pairs such as 'postcode:2000 type:PUB active:Y' or 'charity:Y state:NSW postcode:2000'. All other jurisdictions use plain name search."New value: +"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')."

Removed value: -{
-  "description": "FR only. 2-digit region code.",
-  "type": "string"
-}

Removed value: -{
-  "description": "FI only. Filter companies registered on/before this date (YYYY-MM-DD).",
-  "type": "string"
-}

Removed value: -{
-  "description": "FI only. Filter companies registered on/after this date (YYYY-MM-DD).",
-  "type": "string"
-}

Removed value: -{
-  "description": "CH only. Internal office number of the cantonal registry of commerce. Use get_code_description(CH, registryOfCommerce) to discover. Example: 20 = Zurich. Mutually exclusive with legalSeatId or canton.",
-  "type": "integer"
-}

Removed value: -{
-  "description": "FR only. Maximum résultat net in EUR.",
-  "type": "number"
-}

Removed value: -{
-  "description": "FR only. Minimum résultat net (net profit) in EUR (can be negative).",
-  "type": "number"
-}

Removed value: -{
-  "description": "FR only. Single-letter NAF section A-U.",
-  "type": "string"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "CZ only. Registered-office address filter. Full ARES AdresaFiltr schema supported — use structured RÚIAN codes (kodObce/kodUlice/...) when you have them for exact matches, or free-text (obec/ulice/psc/textovaAdresa) for fuzzy searches. Resolve text to codes via the search_addresses tool.",
-  "properties": {
-    "cisloDomovni": {
-      "description": "House number (before the slash).",
-      "maximum": 9999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "cisloOrientacni": {
-      "description": "Orientation number (after the slash).",
-      "maximum": 999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "cisloOrientacniPismeno": {
-      "description": "Orientation number letter suffix.",
-      "maxLength": 1,
-      "type": "string"
-    },
-    "kodCastiObce": {
-      "description": "RÚIAN district code within municipality.",
-      "maximum": 999999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "kodMestskeCastiObvodu": {
-      "description": "City district code for statutory cities.",
-      "maximum": 999999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "kodObce": {
-      "description": "RÚIAN municipality code (authoritative).",
-      "maximum": 999999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "kodSpravnihoObvodu": {
-      "description": "Prague admin district code.",
-      "maximum": 999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "kodUlice": {
-      "description": "RÚIAN street code.",
-      "maximum": 9999999,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "obec": {
-      "description": "Municipality name (free-text, e.g. 'Praha').",
-      "type": "string"
-    },
-    "psc": {
-      "description": "Postal code (5 digits, optional space).",
-      "type": "string"
-    },
-    "textovaAdresa": {
-      "description": "Unstructured full-text address (overrides free-text obec/psc/ulice).",
-      "type": "string"
-    },
-    "ulice": {
-      "description": "Street name (free-text).",
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "FR only. INSEE employee-count band code.",
-  "type": "string"
-}

Removed value: -{
-  "description": "FR only. Restrict person filter to officers or elected officials.",
-  "enum": [
-    "dirigeant",
-    "elu"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "IS only. Icelandic VSK-númer (VAT number). Usually 5–6 digits (e.g. '11459'). Skatturinn's upstream /leit form redirects a VSK hit straight to the company profile; the adapter surfaces this as a single-candidate result.",
-  "type": "string"
-}

Previous value: -"Full original response fields from the upstream registry, field names unchanged. Shape is jurisdiction-specific — see `list_jurisdictions({ jurisdiction: '<CODE>' })`."New value: +"Full original response fields from the upstream registry, field names unchanged. Shape is jurisdiction-specific - see `list_jurisdictions({ jurisdiction: '<CODE>' })`."