io.github.Company-Gibraltar/company-gibraltar

🇬🇮 company-gibraltar MCP Server

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

7 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
residency_planner	Plan Gibraltar residency routes: pass known facts, get ranked routes with plans, itemised fees vs refundable deposits, department contacts, and the questions still worth asking	JSON

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