company.gi MCP Server
Give your AI assistant working knowledge of Gibraltar. One URL connects Claude, Cursor, or any Model Context Protocol client to eight tools: compliance calculators, pre-filled Companies House form packs, and a residency route planner.
Your AI does the reasoning; we supply the verified rules, fee maths, and department contacts it cannot invent.
Quick start
claude.ai
Settings → Connectors → Add custom connector, then paste the server URL. Available on Pro, Max and Team plans. After that, any claude.ai chat can calculate your deadlines or plan your residency application.
https://company.gi/api/mcp
ChatGPT
Settings → Connectors → Add custom connector, with the same URL. Available on paid plans; on some plans custom connectors live under developer mode in the connector settings.
https://company.gi/api/mcp
Claude Code
claude mcp add --transport http company-gi https://company.gi/api/mcp
Cursor, Windsurf, Claude Desktop
Add to your client’s MCP settings file:
{
"mcpServers": {
"company-gi": {
"url": "https://company.gi/api/mcp"
}
}
}Running locally (stdio)
If you have the repository, the same server runs over stdio:
{
"mcpServers": {
"company-gi": {
"command": "npx",
"args": ["tsx", "mcp/server.ts"],
"env": { "COMPANY_GI_API_URL": "https://company.gi" }
}
}
}The 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 a pre-filled FAR01 annual return form | ZIP |
| registered_office_change | Generate office change forms (FREG01 + board resolution) | ZIP |
| company_formation | Generate a full incorporation pack (5 FINC forms) | ZIP |
| egov_account | Generate eGov account application forms | |
| residency_planner | Plan Gibraltar residency routes: pass known facts, get every route ranked with an ordered plan, itemised fees vs refundable deposits, department contacts, and the questions still worth asking | JSON |
| hero_image | Generate branded hero images with configurable layout | PNG |
How it works
- The endpoint at
/api/mcpspeaks MCP’s streamable HTTP transport with per-session state, and sends CORS headers so browser-based clients work too. - Every tool wraps a public REST endpoint under
/api/tools/, so anything you can do over MCP you can also do with plain HTTP. See the API documentation and playground, or the OpenAPI spec. - Calculators return JSON; form generators return base64-encoded PDFs and ZIPs your client saves to disk.
- Everything is deterministic code on our side, so answers are consistent: the same facts always produce the same plan, fees and dates.
The interview pattern: residency_planner
Most tools are one-shot. The residency planner is built for a conversation: it accepts partial information, treats “unknown” as a valid answer, and tells your agent what to ask next. The loop:
// 1. Your agent calls residency_planner with what it knows
{ "workType": "working-director", "dobRegistered": "unknown" }
// 2. The response ranks every route AND lists what to ask next
{
"unansweredQuestions": [
{ "fact": "ageBand", "question": "How old are you?", ... },
{ "fact": "salaryMeets37500", "question": "Will your gross annual earnings be at least £37,500?", ... }
],
"routes": [
{
"route": { "id": "working-director", ... },
"status": "needs-info",
"plan": [
{
"id": "confirm-dob-registration",
"title": "Confirm the business is on the Department of Business register",
"ask": ["Is <company> on the business register?", "What date was it registered?"],
"contact": { "email": "[email protected]", "phone": "+350 200 71700" }
},
...
],
"costs": { "items": [ { "label": "Residency application fee", "amountGbp": 250, "kind": "fee" }, ... ] }
},
...
]
}
// 3. The agent asks the human, folds answers in, calls again.
// "Unknown" is always valid: plans start with how to find each unknown out.The same engine powers the Residency Route Planner on this site, and covers the rules that apply to applications made on or after 6 October 2025. It is guidance, not legal or immigration advice; the official rules live at residency.gov.gi.