{"openapi":"3.0.3","info":{"title":"Gnist Context — Companies House (UK)","description":"UK Companies House — company search, profiles, officers, and filing history.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/companies-house/`\n- **Toolkit page:** `/toolkits/companies-house`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/companies-house/search_uk_companies":{"post":{"tags":["Business"],"summary":"search_uk_companies","description":"Search for UK companies by name on Companies House.\n\nCompanies House is the UK's official company registry, covering 5+ million\ncompanies including PLCs, LTDs, LLPs, and foreign branches registered in\nEngland, Wales, Scotland, and Northern Ireland.\n\nArgs:\n    query: Company name to search for.\n    limit: Number of results (1–100, default 10).\n\nReturns:\n    Dict with 'count' and 'companies' list. Each result includes company_number,\n    title, company_status, company_type, date_of_creation, and address_snippet.","operationId":"companies_house_search_uk_companies","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Company name to search for (e.g. \"Tesco\", \"Barclays\", \"Rolls-Royce\").","type":"string"},"limit":{"default":10,"description":"Number of results to return (1–100, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/companies-house/lookup_uk_company":{"post":{"tags":["Business"],"summary":"lookup_uk_company","description":"Look up a UK company by its Companies House company number.\n\nReturns the full company profile including name, status, type, SIC codes,\nregistered address, jurisdiction, and previous names.\n\nCompany numbers are 8 characters — numeric for English/Welsh companies,\nprefixed with SC (Scotland), NI (Northern Ireland), or other codes.\n\nArgs:\n    company_number: The Companies House company number.\n\nReturns:\n    Dict with full company profile, or {\"error\": \"not_found\"} if not found.","operationId":"companies_house_lookup_uk_company","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"company_number":{"description":"UK company number (e.g. \"00445790\" for Tesco PLC, \"SC123456\" for a Scottish company).","type":"string"}},"required":["company_number"],"type":"object"}}}}}},"/rest/companies-house/list_uk_company_officers":{"post":{"tags":["Business"],"summary":"list_uk_company_officers","description":"List directors, secretaries, and other officers for a UK company.\n\nReturns current and past officers with their roles, appointment dates,\nnationality, and occupation. Resigned officers include their resignation date.\n\nArgs:\n    company_number: The Companies House company number.\n    limit: Number of results (1–100, default 20).\n\nReturns:\n    Dict with 'company_number', 'count', and 'officers' list.","operationId":"companies_house_list_uk_company_officers","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"company_number":{"description":"UK company number.","type":"string"},"limit":{"default":20,"description":"Number of officers to return (1–100, default 20).","type":"integer"}},"required":["company_number"],"type":"object"}}}}}},"/rest/companies-house/list_uk_company_filings":{"post":{"tags":["Business"],"summary":"list_uk_company_filings","description":"List filing history for a UK company.\n\nReturns recent filings including accounts, annual returns, officer changes,\nand other regulatory submissions to Companies House.\n\nArgs:\n    company_number: The Companies House company number.\n    category: Optional filter by filing category.\n    limit: Number of results (1–100, default 20).\n\nReturns:\n    Dict with 'company_number', 'count', and 'filings' list.","operationId":"companies_house_list_uk_company_filings","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"company_number":{"description":"UK company number.","type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by filing category: \"accounts\", \"officers\", \"address\", \"annual-return\", \"capital\", \"change-of-name\", \"incorporation\", \"liquidation\", \"miscellaneous\", \"mortgage\", \"resolution\"."},"limit":{"default":20,"description":"Number of filings to return (1–100, default 20).","type":"integer"}},"required":["company_number"],"type":"object"}}}}}},"/rest/companies-house/report_feedback":{"post":{"tags":["Business"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"companies_house_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Business","description":"Data sources: Business"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}