🇬🇮 company-gibraltar MCP Server

![npm](https://www.npmjs.com/package/company-gibraltar-mcp) ![License: MIT](https://opensource.org/licenses/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

| Tool | Description | Returns | |------|-------------|---------| | poa_calculator | Calculate Payments on Account (corporate tax instalments) | JSON | | deadlines | Calculate all compliance deadlines for a given year | JSON | | annual_return | Generate pre-filled FAR01 annual return form | ZIP | | registered_office_change | Generate office change forms (FREG01 + board resolution) | ZIP | | company_formation | Generate full incorporation pack (5 FINC forms) | ZIP | | egov_account | Generate eGov account application forms | PDF |

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"

License

MIT

company-gibraltar-mcp