About company-gibraltar
company-gibraltar is an MCP server for Gibraltar company administration, aimed at agents handling tax, compliance and company filings. It combines calculations and deadline checks with pre-filled PDF and ZIP form packs, plus residency planning.
Key features
- 01Corporate tax instalment calculations
- 02Annual compliance deadline checks
- 03Pre-filled company filing forms
- 04Company formation and eGov packs
- 05Ranked Gibraltar residency routes
Use cases
- 01Estimating corporate tax instalments
- 02Checking a company’s compliance dates
- 03Preparing annual return or incorporation documents
- 04Comparing residency routes, fees and deposits
MCP support
The server exposes seven company and residency tools to MCP clients, including structured calculations and generated PDF or ZIP forms. It validates inputs and forwards requests to the company.gi REST API.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| taxRate | string | No | Corporate tax rate percentage. Defaults to 15. |
| lastYearTax | string | No | Last year total tax liability in GBP. Provide this OR lastYearProfit. |
| paymentYear | string | No | Year for POA dates. Defaults to current year. |
| lastYearProfit | string | No | Last year taxable profit in GBP. Provide this OR lastYearTax. |
Details
From the project README🇬🇮 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 | |
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.