Company Gi

npm License: MIT

Gibraltar company tools for AI agents. Calculate corporate tax payments, check compliance deadlines, and generate pre-filled PDF form packs for Gibraltar Companies House.

6 tools, no API key, no rate limiting.

Tools

Install

npm install -g company-gibraltar-mcp

Or run directly with npx (no install needed):

npx company-gibraltar-mcp

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "company-gibraltar": {
      "command": "npx",
      "args": ["-y", "company-gibraltar-mcp"],
      "env": {
        "COMPANY_GI_API_URL": "https://company.gi"
      }
    }
  }
}

Claude Code

claude mcp add company-gibraltar -- npx -y company-gibraltar-mcp

Cursor / Windsurf

Same configuration format in your MCP settings file:

{
  "mcpServers": {
    "company-gibraltar": {
      "command": "npx",
      "args": ["-y", "company-gibraltar-mcp"],
      "env": {
        "COMPANY_GI_API_URL": "https://company.gi"
      }
    }
  }
}

How it works

This MCP server is a thin wrapper around the company.gi REST API. Each tool validates input with Zod and forwards the request to the corresponding API endpoint. The actual business logic (tax calculations, PDF generation, deadline calculations) runs on the server.

• JSON tools (POA calculator, deadlines) return structured data
• Binary tools (annual return, office change, formation, eGov) return base64-encoded PDFs/ZIPs

Example usage

Ask your AI assistant:

• "Calculate my payments on account for 2026 if last year's tax was 5000"
• "What are my compliance deadlines? My company was incorporated on 2023-06-15"
• "Generate an annual return form for company number 12345"
• "Create a company formation pack for a new company called Acme Limited"

Links

• API Documentation
• API Playground
• OpenAPI Spec
• company.gi

License

MIT