Companies House MCP - v3.1.0

What's Changed

🐛 Bug Fixes

• Fixed document API 404 errors by using the correct base URL (document-api.company-information.service.gov.uk)
• Document endpoints now properly handle both plain document IDs and full URLs from filing history responses

✨ Features

• get_document_metadata - Retrieve document metadata from Companies House filings
• get_document_content - Download PDF content of company documents

🔧 Technical Improvements

• Added extractDocumentId method to handle multiple input formats
• Improved error handling for document API requests
• Updated tests to match new implementation

Installation

npm install [email protected]

Full Changelog

v3.0.0...v3.1.0

Release v3.0.0 - Document API Support

🎉 Release v3.0.0 - Document API Support

✨ What's New

This major release adds support for the Companies House Document API, enabling retrieval of document metadata and content.

📄 Document API Endpoints

• Document Metadata: GET /document/{document_id} - Retrieve document metadata including company number, category, pages, and links
• Document Content: GET /document/{document_id}/content - Download document content as PDF

🚀 Features

• Full TypeScript Support: Type-safe schemas for all document operations
• Comprehensive Test Coverage: 23 new tests covering all document functionality
• Binary Content Handling: Proper support for PDF document downloads
• Error Handling: Robust error handling for all document operations
• MCP Integration: Seamless integration with the MCP server framework

📦 Installation

npm install [email protected]

🔧 New MCP Tools

• get_document_metadata - Fetch document metadata
• get_document_content - Download document PDF content

📝 Example Usage

// Get document metadata
const metadata = await client.document.getDocumentMetadata({ 
  document_id: 'doc123' 
});

// Download document content
const pdfBuffer = await client.document.getDocumentContent({ 
  document_id: 'doc123' 
});

🧪 Testing

All new features are fully tested with:

• Unit tests for API clients
• Handler tests with mock data
• Type validation tests
• Error handling tests

🔄 Breaking Changes

None - This release is fully backward compatible.

📚 Documentation

For detailed documentation and examples, please refer to the README.

🙏 Contributors

Thank you to all contributors who made this release possible!

---

Full Changelog: v2.0.1...v3.0.0

Companies House MCP Server - v2.0.1

What's Fixed

• Added bin field to package.json to enable proper npx execution
• Fixes MCP server connection issues when installed via npm

Installation

npm install companies-house-mcp-server

Or use with npx:

npx -y companies-house-mcp-server

Full Changelog

v2.0.0...v2.0.1

Companies House MCP Server - v2.0.0

🎉 Major Release - Complete API Coverage

This is a major release that implements ALL 45+ Companies House API endpoints with a completely refactored modular architecture.

✨ What's New

🚀 Complete API Coverage

• Company Information (7 endpoints) - Profile, addresses, registers, insolvency, exemptions, UK establishments
• Advanced Search (6 endpoints) - Companies, officers, disqualified officers, alphabetical, dissolved, unified search
• Officers & Appointments (5 endpoints) - Officers list, appointments, disqualifications
• Filing History (2 endpoints) - Full history and individual items
• Charges (2 endpoints) - List and details
• PSC (13 endpoints) - Persons with Significant Control, statements, verifications

🏗️ Architecture Improvements

• Modular design - Separated API clients, handlers, types, and tools
• Type safety - Comprehensive Zod schemas for all endpoints
• No more any types - Full TypeScript coverage
• Better error handling - Detailed error messages with context

📚 Enhanced Documentation

• Examples for all 45+ endpoints
• Clear architecture documentation
• Comprehensive setup instructions
• Rate limiting information

🐳 Docker Support

• Multi-platform builds (linux/amd64, linux/arm64)
• Automated Docker Hub publishing
• Available at: stefanoamorelli/companies-house-mcp

💔 Breaking Changes

• API client structure changed from flat to modular:

  // Old
  client.searchCompanies()
  
  // New
  client.company.searchCompanies()

• Server version bumped to 2.0.0
• Type definitions reorganized into separate modules

📦 Installation

Via npm:

```bash
npm install -g companies-house-mcp-server
```

Via Docker:

```bash
docker pull stefanoamorelli/companies-house-mcp:v2.0.0
```

Claude Desktop Configuration:

```json
{
"mcpServers": {
"companies-house": {
"command": "npx",
"args": ["-y", "companies-house-mcp-server"],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here"
}
}
}
}
```

🙏 Acknowledgments

Thanks to all contributors and users for their feedback and support!

📄 License

GNU Affero General Public License v3.0

For commercial licensing: [email protected]

Companies House MCP - v1.0.1

🐛 Bug Fixes

• Fixed ESLint configuration to use typescript-eslint v8
• Updated dependencies for better CI/CD compatibility

🔧 Maintenance

• Migrated from separate @typescript-eslint packages to unified typescript-eslint
• Improved development tooling configuration

📦 Installation

npm install companies-house-mcp

🚀 Quick Start

See the README for usage instructions and examples.

---

Published to NPM: https://www.npmjs.com/package/companies-house-mcp