Search officers by name
search_officersFind current or past officers (director, secretary, member, partner) in a jurisdiction's registry by name. Returns candidate details and appointment count for person-centric investigations.
Instructions
Find people holding or who held officer positions (director, secretary, member, partner) in a jurisdiction's registry by name. Returns candidates with officer_id, name, and (where exposed) appointment count. Entry point for person-centric investigations.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"jurisdiction": "<jurisdiction>",
"query": "<query>"
},
"name": "search_officers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jurisdiction | Yes | ISO 3166-1 alpha-2 country code (uppercase). All registries are official government sources. Currently supported: AU, BE, CA, CA-BC, CA-NT, CH, CY, CZ, DE, ES, FI, FR, GB, HK, IE, IM, IS, IT, KR, KY, LI, MC, MX, MY, NL, NO, NZ, PL, RU, TW. Per-country capability, ID format, examples, status mapping, and caveats: call `list_jurisdictions({jurisdiction:'<code>'})`. To find which countries support a specific tool: `list_jurisdictions({supports_tool:'<tool>'})`. | |
| query | Yes | Officer name. Full names work best ('John Smith'). Partial names return more candidates. | |
| limit | No | Max officer candidates to return. Range 1-100, default 20. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queried_at | Yes | ISO-8601 + Europe/London timezone stamp for when the registry was queried. | |
| jurisdiction | No | ||
| query | No | ||
| count | No | ||
| officers | No | ||
| data | No | Adapters returning a bare array are wrapped here by textResult(). |