English Français العربية

io.github.Company-Gibraltar/company-gi

السجل الرسمي الإنتاجية

Gibraltar company tools: corporate tax, compliance deadlines, and PDF form generation.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package company-gi-mcp
Claude Code 
claude mcp add company-gi -- npx -y company-gi-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "company-gi": {
            "command": "npx",
            "args": [
                "-y",
                "company-gi-mcp@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🇬🇮 company-gibraltar MCP Server
  2. Tools
  3. Install
  4. Setup
  5. How it works
  6. Example usage
  7. Links
  8. License

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

ToolDescriptionReturns
poa_calculatorCalculate Payments on Account (corporate tax instalments)JSON
deadlinesCalculate all compliance deadlines for a given yearJSON
annual_returnGenerate pre-filled FAR01 annual return formZIP
registered_office_changeGenerate office change forms (FREG01 + board resolution)ZIP
company_formationGenerate full incorporation pack (5 FINC forms)ZIP
egov_accountGenerate eGov account application formsPDF
residency_plannerPlan Gibraltar residency routes: pass known facts, get ranked routes with plans, itemised fees vs refundable deposits, department contacts, and the questions still worth askingJSON

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"

License

MIT

الأسئلة الشائعة

ما هو io.github.Company-Gibraltar/company-gi؟

Gibraltar company tools: corporate tax, compliance deadlines, and PDF form generation.

كيف أثبّت io.github.Company-Gibraltar/company-gi؟

يعمل على جهازك. في Claude Code: claude mcp add company-gi -- npx -y company-gi-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Company-Gibraltar/company-gi إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Company-Gibraltar/company-gi مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Company-Gibraltar/company-gi؟

ينشره Company-Gibraltar. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.