Business
Data source: UK Companies House
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/companies-house/
claude_desktop_config.json
{
"mcpServers": {
"gnist-companies-house": {
"url": "https://context.gnist.ai/mcp/companies-house/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/companies-house/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_uk_companies", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/companies-house/
5 endpoints available:
GET /rest/companies-house/search_uk_companiesGET /rest/companies-house/lookup_uk_companyGET /rest/companies-house/list_uk_company_officersGET /rest/companies-house/list_uk_company_filingsGET /rest/companies-house/report_feedback
Shell
curl "https://context.gnist.ai/rest/companies-house/search_uk_companies?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/companies-house/search_uk_companies",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc companies-house
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
search_uk_companiesSearch for UK companies by name on Companies House.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Company name to search for (e.g. "Tesco", "Barclays", "Rolls-Royce"). |
limit | integer | optional | Number of results to return (1–100, default 10). (default: 10) |
lookup_uk_companyLook up a UK company by its Companies House company number.
| Parameter | Type | Required | Description |
|---|---|---|---|
company_number | string | required | UK company number (e.g. "00445790" for Tesco PLC, "SC123456" for a Scottish company). |
list_uk_company_officersList directors, secretaries, and other officers for a UK company.
| Parameter | Type | Required | Description |
|---|---|---|---|
company_number | string | required | UK company number. |
limit | integer | optional | Number of officers to return (1–100, default 20). (default: 20) |
list_uk_company_filingsList filing history for a UK company.
| Parameter | Type | Required | Description |
|---|---|---|---|
company_number | string | required | UK company number. |
category | any | optional | Filter by filing category: "accounts", "officers", "address", "annual-return", "capital", "change-of-name", "incorporation", "liquidation", "miscellaneous", "mortgage", "resolution". |
limit | integer | optional | Number of filings to return (1–100, default 20). (default: 20) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |