{
  "markdown": "# 🇬🇮 company-gibraltar MCP Server\n\n[![npm](https://img.shields.io/npm/v/company-gibraltar-mcp)](https://www.npmjs.com/package/company-gibraltar-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nGibraltar company tools for AI agents. Calculate corporate tax payments, check compliance deadlines, and generate pre-filled PDF form packs for Gibraltar Companies House.\n\n7 tools, no API key, no rate limiting.\n\n## Tools\n\n| Tool | Description | Returns |\n|------|-------------|---------|\n| `poa_calculator` | Calculate Payments on Account (corporate tax instalments) | JSON |\n| `deadlines` | Calculate all compliance deadlines for a given year | JSON |\n| `annual_return` | Generate pre-filled FAR01 annual return form | ZIP |\n| `registered_office_change` | Generate office change forms (FREG01 + board resolution) | ZIP |\n| `company_formation` | Generate full incorporation pack (5 FINC forms) | ZIP |\n| `egov_account` | Generate eGov account application forms | PDF |\n| `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 |\n\n## Install\n\n```bash\nnpm install -g company-gibraltar-mcp\n```\n\nOr run directly with npx (no install needed):\n\n```bash\nnpx company-gibraltar-mcp\n```\n\n## Setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"company-gibraltar\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"company-gibraltar-mcp\"],\n      \"env\": {\n        \"COMPANY_GI_API_URL\": \"https://company.gi\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add company-gibraltar -- npx -y company-gibraltar-mcp\n```\n\n### Cursor / Windsurf\n\nSame configuration format in your MCP settings file:\n\n```json\n{\n  \"mcpServers\": {\n    \"company-gibraltar\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"company-gibraltar-mcp\"],\n      \"env\": {\n        \"COMPANY_GI_API_URL\": \"https://company.gi\"\n      }\n    }\n  }\n}\n```\n\n## How it works\n\nThis MCP server is a thin wrapper around the [company.gi REST API](https://company.gi/developers). 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.\n\n- **JSON tools** (POA calculator, deadlines) return structured data\n- **Binary tools** (annual return, office change, formation, eGov) return base64-encoded PDFs/ZIPs\n\n## Example usage\n\nAsk your AI assistant:\n\n- \"Calculate my payments on account for 2026 if last year's tax was 5000\"\n- \"What are my compliance deadlines? My company was incorporated on 2023-06-15\"\n- \"Generate an annual return form for company number 12345\"\n- \"Create a company formation pack for a new company called Acme Limited\"\n\n## Links\n\n- [API Documentation](https://company.gi/developers)\n- [API Playground](https://company.gi/developers/playground)\n- [OpenAPI Spec](https://company.gi/openapi.json)\n- [company.gi](https://company.gi)\n\n## License\n\nMIT\n",
  "bytes": 3140,
  "sha": "37d2d263238ac66562f8b250455e363b29ab3846642af2613088d54c245a59d5",
  "repo_slug": "company-gibraltar/company-gibraltar-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_company_gibraltar_company_gibr_340cbfbd/readme"
}