直布罗陀企业税务工具

提供直布罗陀企业税务计算、合规期限检查及预填PDF表格生成的一站式解决方案。

  • by Company-Gibraltar
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Company-Gibraltar/company-gibraltar-mcp

使用说明

🇬🇮 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

License

MIT