get_company
Pack: companies-house · Endpoint: https://gateway.pipeworx.io/companies-house/mcp
Fetch a single UK company profile by company number. Returns registered name, status, type, SIC codes, registered office, accounts/confirmation-statement due dates, and links to officers/filings/charges/PSCs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_number | string | yes | UK company number (e.g., “00006245”) |
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_company","arguments":{}}}'Response shape
Always returns: company_number, name, status, type, sic_codes, incorporated_on
| Field | Type | Description |
|---|---|---|
company_number | string | null | UK company number |
name | string | null | Registered company name |
status | string | null | Company status (active, dissolved, etc.) |
status_detail | string | null | Additional status details |
type | string | null | Company type (private limited, public limited, etc.) |
jurisdiction | string | null | Company jurisdiction (England and Wales, Scotland, etc.) |
sic_codes | array | Standard Industrial Classification codes |
incorporated_on | string | null | Incorporation date (ISO format) |
dissolved_on | string | null | Dissolution date (ISO format) if applicable |
registered_office | object | null | Registered office address details |
accounts_next_due | string | null | Next accounts filing due date (ISO format) |
accounts_next_made_up_to | string | null | Next accounts period end date (ISO format) |
last_accounts_made_up_to | string | null | Last filed accounts period end date (ISO format) |
confirmation_statement_next_due | string | null | Next confirmation statement due date (ISO format) |
ch_url | string | null | Link to company profile on Companies House website |
Full JSON Schema
{
"type": "object",
"properties": {
"company_number": {
"type": [
"string",
"null"
],
"description": "UK company number"
},
"name": {
"type": [
"string",
"null"
],
"description": "Registered company name"
},
"status": {
"type": [
"string",
"null"
],
"description": "Company status (active, dissolved, etc.)"
},
"status_detail": {
"type": [
"string",
"null"
],
"description": "Additional status details"
},
"type": {
"type": [
"string",
"null"
],
"description": "Company type (private limited, public limited, etc.)"
},
"jurisdiction": {
"type": [
"string",
"null"
],
"description": "Company jurisdiction (England and Wales, Scotland, etc.)"
},
"sic_codes": {
"type": "array",
"description": "Standard Industrial Classification codes",
"items": {
"type": "string"
}
},
"incorporated_on": {
"type": [
"string",
"null"
],
"description": "Incorporation date (ISO format)"
},
"dissolved_on": {
"type": [
"string",
"null"
],
"description": "Dissolution date (ISO format) if applicable"
},
"registered_office": {
"type": [
"object",
"null"
],
"description": "Registered office address details",
"properties": {
"address_line_1": {
"type": "string"
},
"address_line_2": {
"type": "string"
},
"locality": {
"type": "string"
},
"region": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string"
}
}
},
"accounts_next_due": {
"type": [
"string",
"null"
],
"description": "Next accounts filing due date (ISO format)"
},
"accounts_next_made_up_to": {
"type": [
"string",
"null"
],
"description": "Next accounts period end date (ISO format)"
},
"last_accounts_made_up_to": {
"type": [
"string",
"null"
],
"description": "Last filed accounts period end date (ISO format)"
},
"confirmation_statement_next_due": {
"type": [
"string",
"null"
],
"description": "Next confirmation statement due date (ISO format)"
},
"ch_url": {
"type": [
"string",
"null"
],
"description": "Link to company profile on Companies House website"
}
},
"required": [
"company_number",
"name",
"status",
"type",
"sic_codes",
"incorporated_on"
]
}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.