get_officers
Pack: companies-house · Endpoint: https://gateway.pipeworx.io/companies-house/mcp
List directors and secretaries for a UK company. Returns name, role, appointment/resignation dates, occupation, country of residence, nationality, and date of birth (month/year only).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_number | string | yes | UK company number |
items_per_page | number | no | 1-100 (default 35) |
start_index | number | no | Pagination offset (default 0) |
register_type | string | no | directors | secretaries | llp-members (optional restriction) |
Example call
curl -X POST https://gateway.pipeworx.io/companies-house/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_officers","arguments":{}}}'
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"companies-house": {
"url": "https://gateway.pipeworx.io/companies-house/mcp"
}
}
}
See Getting Started for client-specific install steps.