{"_id":"@biznezstack/companieshouse-mcp","_rev":"2-6de0114bc8f55fc38d2070d8a61b9660","name":"@biznezstack/companieshouse-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@biznezstack/companieshouse-mcp","version":"1.0.0","keywords":["mcp","companies-house","uk-companies","company-data","model-context-protocol","claude","ai","business-intelligence"],"author":{"name":"manimaun"},"license":"MIT","_id":"@biznezstack/companieshouse-mcp@1.0.0","maintainers":[{"name":"biznezstack","email":"hello@biznezstack.com"}],"homepage":"https://github.com/manimaun/companieshouse-mcp#readme","bugs":{"url":"https://github.com/manimaun/companieshouse-mcp/issues"},"bin":{"companieshouse-mcp":"dist/index.js"},"dist":{"shasum":"436df7e49106f2f17aef7e53699e409fdae780cb","tarball":"https://registry.npmjs.org/@biznezstack/companieshouse-mcp/-/companieshouse-mcp-1.0.0.tgz","fileCount":7,"integrity":"sha512-ab5CnlMZ764NVbbfaDLVpIzFawXXWobaVC/lyK+sZDNa3uk300mBl79aGNcBiIEWxqQRUxX8CeibJw9LnVFUCQ==","signatures":[{"sig":"MEUCICOouqyIi3933+/XuusbJtPVnxJaSiUnDNolFObE/lxFAiEA79oV92m2Ub/6wBY8WxSb5+xS86gENA8PuOgu7uLjLjk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39004},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","start":"node dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"biznezstack","email":"hello@biznezstack.com"},"repository":{"url":"git+https://github.com/manimaun/companieshouse-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"MCP server providing access to UK Companies House API for company data, filings, officers, and more","directories":{},"_nodeVersion":"22.18.0","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/companieshouse-mcp_1.0.0_1759508126003_0.6129287587022065","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@biznezstack/companieshouse-mcp","version":"1.0.1","description":"MCP server providing access to UK Companies House API for company data, filings, officers, and more","main":"dist/index.js","type":"module","bin":{"companieshouse-mcp":"dist/index.js"},"scripts":{"build":"tsc","prepare":"npm run build","watch":"tsc --watch","start":"node dist/index.js"},"keywords":["mcp","companies-house","uk-companies","company-data","model-context-protocol","claude","ai","business-intelligence"],"author":{"name":"manimaun"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/manimaun/companieshouse-mcp.git"},"homepage":"https://github.com/manimaun/companieshouse-mcp#readme","bugs":{"url":"https://github.com/manimaun/companieshouse-mcp/issues"},"_id":"@biznezstack/companieshouse-mcp@1.0.1","types":"./dist/index.d.ts","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-HVQVubJSsr8nMAmbPbrx7vj0iz4eSBmpiBuapTYT3rddlUZiaYJtDcagmiIphnvyUwsQpR9QZmcP+dZRohlPNA==","shasum":"c1057db97ca7aeafc588c8a42ef5c5d3891c0512","tarball":"https://registry.npmjs.org/@biznezstack/companieshouse-mcp/-/companieshouse-mcp-1.0.1.tgz","fileCount":7,"unpackedSize":40676,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCetMo95FpVbERBCxzRUDdyzjJAxHZp0oDUUV+18nvDZAIgCkaNogKMUrcG4hArcyLwuTn6CQCqa/9DFzN4UnD7y9E="}]},"_npmUser":{"name":"biznezstack","email":"hello@biznezstack.com"},"directories":{},"maintainers":[{"name":"biznezstack","email":"hello@biznezstack.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/companieshouse-mcp_1.0.1_1759508203737_0.10412156232038239"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-03T16:15:25.882Z","modified":"2025-10-03T16:16:44.124Z","1.0.0":"2025-10-03T16:15:26.218Z","1.0.1":"2025-10-03T16:16:43.930Z"},"bugs":{"url":"https://github.com/manimaun/companieshouse-mcp/issues"},"author":{"name":"manimaun"},"license":"MIT","homepage":"https://github.com/manimaun/companieshouse-mcp#readme","keywords":["mcp","companies-house","uk-companies","company-data","model-context-protocol","claude","ai","business-intelligence"],"repository":{"type":"git","url":"git+https://github.com/manimaun/companieshouse-mcp.git"},"description":"MCP server providing access to UK Companies House API for company data, filings, officers, and more","maintainers":[{"name":"biznezstack","email":"hello@biznezstack.com"}],"readme":"# Companies House MCP Server\n\nA Model Context Protocol (MCP) server providing comprehensive access to the UK Companies House API. Search companies, get detailed profiles, officer information, filing history, persons with significant control, charges, and more.\n\n## Features\n\n- 🔍 **Company Search** - Search for companies by name or number\n- 🏢 **Company Profiles** - Get detailed company information\n- 👥 **Officers** - Access director and secretary information\n- 📄 **Filing History** - View company filings and submissions\n- 🎯 **PSC Data** - Persons with Significant Control information\n- ⚖️ **Charges** - View registered charges against companies\n- 💼 **Insolvency** - Company insolvency information\n- 🚫 **Disqualified Officers** - Search for disqualified directors\n\n## Installation & Setup\n\n### Step 1: Get Your Companies House API Key\n\nGet a **free** API key from Companies House:\n\n1. Visit **https://developer.company-information.service.gov.uk/**\n2. Click \"Register\" and create an account\n3. Sign in and click \"Register an application\"\n4. Fill in the application details (name can be anything like \"Claude MCP\")\n5. Copy your API key (it looks like: `5e9be388-f0e1-4b5a-bc44-982aba20227a`)\n\n### Step 2: Configure Claude Desktop\n\n**MacOS**: Open `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: Open `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**Copy and paste this configuration** (replace `YOUR_API_KEY_HERE` with your actual API key):\n\n```json\n{\n  \"mcpServers\": {\n    \"companieshouse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@biznezstack/companieshouse-mcp\"],\n      \"env\": {\n        \"COMPANIESHOUSE_API_KEY\": \"YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n**Example with a real API key:**\n```json\n{\n  \"mcpServers\": {\n    \"companieshouse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@biznezstack/companieshouse-mcp\"],\n      \"env\": {\n        \"COMPANIESHOUSE_API_KEY\": \"5e9be388-f0e1-4b5a-bc44-982aba20227a\"\n      }\n    }\n  }\n}\n```\n\n> **Note**: If you already have other MCP servers configured, just add the `companieshouse` entry inside your existing `mcpServers` object.\n\n### Step 3: Restart Claude Desktop\n\n1. **Quit** Claude Desktop completely\n2. **Reopen** Claude Desktop\n3. The Companies House MCP server will load automatically\n\n### Step 4: Test It Works\n\nIn Claude, try asking:\n- *\"Search for companies named HSBC\"*\n- *\"Get company profile for 00000006\"*\n\nYou should see Claude using the Companies House tools to fetch real data!\n\n---\n\n### 📋 Already Have Other MCP Servers?\n\nIf your Claude config already has other servers, combine them like this:\n\n```json\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/path/to/allowed/files\"]\n    },\n    \"companieshouse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@biznezstack/companieshouse-mcp\"],\n      \"env\": {\n        \"COMPANIESHOUSE_API_KEY\": \"YOUR_API_KEY_HERE\"\n      }\n    },\n    \"github\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"],\n      \"env\": {\n        \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"your_github_token\"\n      }\n    }\n  }\n}\n```\n\nJust add the `companieshouse` block alongside your existing servers!\n\n---\n\n## Usage Examples\n\nOnce configured, you can ask Claude questions like:\n\n- \"Search for companies named 'Tech Solutions'\"\n- \"Get the company profile for company number 00000006\"\n- \"Who are the directors of HSBC Holdings plc?\"\n- \"Show me the filing history for company 12345678\"\n- \"Find persons with significant control for company XYZ Ltd\"\n- \"Are there any charges registered against company ABC123?\"\n- \"Search for disqualified officers named John Smith\"\n\n## Available Tools\n\n### Company Search & Lookup\n- `search_companies` - Search for UK companies\n- `search_companies_alphabetically` - Alphabetical company search\n- `search_dissolved_companies` - Search dissolved companies\n- `get_company_profile` - Get detailed company profile\n- `get_company_registered_office` - Get registered office address\n\n### Officers\n- `get_company_officers` - List company officers\n- `search_officers` - Search for officers by name\n- `get_officer_appointments` - Get all appointments for an officer\n\n### Filing History\n- `get_company_filing_history` - Get company filings\n- `get_filing_history_item` - Get specific filing details\n\n### Persons with Significant Control (PSC)\n- `get_company_psc` - List PSCs for a company\n- `get_individual_psc` - Get individual PSC details\n- `get_corporate_entity_psc` - Get corporate entity PSC details\n- `get_legal_person_psc` - Get legal person PSC details\n\n### Charges\n- `get_company_charges` - List company charges\n- `get_charge_details` - Get specific charge details\n\n### Other Information\n- `get_company_insolvency` - Insolvency information\n- `get_company_exemptions` - Company exemptions\n- `get_company_registers` - Register information\n- `get_uk_establishments` - UK establishments for overseas companies\n\n### Disqualified Officers\n- `search_disqualified_officers` - Search disqualified officers\n- `get_natural_disqualification` - Natural person disqualification details\n- `get_corporate_disqualification` - Corporate disqualification details\n\n## Development\n\n### Local Development\n\n1. Clone the repository\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Build the project:\n   ```bash\n   npm run build\n   ```\n\n4. For development with auto-rebuild:\n   ```bash\n   npm run watch\n   ```\n\n### Testing Locally\n\nTo test the server locally, you can run it directly with your API key:\n\n```bash\nexport COMPANIESHOUSE_API_KEY=your_api_key_here\nnpm run build\nnode dist/index.js\n```\n\n## API Rate Limits\n\nThe Companies House API has rate limits:\n- 600 requests per 5 minutes per IP address\n\nPlease be mindful of these limits when making requests.\n\n## Resources\n\n- [Companies House Developer Hub](https://developer.company-information.service.gov.uk/)\n- [API Documentation](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nFor issues related to:\n- **This MCP Server**: Open an issue on GitHub\n- **Companies House API**: Contact Companies House support\n- **Claude Desktop**: Contact Anthropic support\n\n\n","readmeFilename":"README.md"}