get_persons_with_significant_control
Pack: companies-house · Endpoint: https://gateway.pipeworx.io/companies-house/mcp
Beneficial-ownership records (PSCs) for a UK company — individuals or entities with significant control. Returns name, kind, nature of control, ownership-of-shares brackets, and country of residence.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_number | string | yes | UK company number |
items_per_page | number | no | 1-100 (default 25) |
start_index | number | no | Pagination offset (default 0) |
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_persons_with_significant_control","arguments":{}}}'Response shape
Always returns: company_number, total, persons
| Field | Type | Description |
|---|---|---|
company_number | string | UK company number |
total | number | Total number of persons with significant control |
persons | array | List of beneficial owners with significant control |
Full JSON Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "UK company number"
},
"total": {
"type": "number",
"description": "Total number of persons with significant control"
},
"persons": {
"type": "array",
"description": "List of beneficial owners with significant control",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Name of person or entity with significant control"
},
"kind": {
"type": [
"string",
"null"
],
"description": "Kind of person (individual, corporate-entity, etc.)"
},
"natures_of_control": {
"type": "array",
"description": "Nature(s) of control exercised",
"items": {
"type": "string"
}
},
"country_of_residence": {
"type": [
"string",
"null"
],
"description": "Country of residence"
},
"nationality": {
"type": [
"string",
"null"
],
"description": "Nationality"
},
"notified_on": {
"type": [
"string",
"null"
],
"description": "Date PSC entry was notified (ISO format)"
},
"ceased_on": {
"type": [
"string",
"null"
],
"description": "Date PSC ceased (ISO format) if applicable"
},
"address": {
"type": [
"object",
"null"
],
"description": "Address details of PSC"
},
"identification": {
"type": [
"object",
"null"
],
"description": "Identification details"
}
}
}
}
},
"required": [
"company_number",
"total",
"persons"
]
}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.