PoliErgaleio Public Calculation API & MCP Server

Free MCP server and REST API for Cyprus income tax, state pension, retirement stress test and unemployment benefit calculations. Setup guides for Claude Desktop, ChatGPT, Gemini and Cursor.

Endpoints

MCP endpoint	`https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/mcp`
REST tools endpoint	`https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/tools` (list) · `https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/tools/<tool_name>` (POST, call)
Machine-readable schemas	`https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/schemas` and `https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/schemas/<tool_name>`
Discovery manifest	`https://poliergaleio.com/.well-known/mcp.json`
Verify a key	`https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/whoami` · https://poliergaleio.com/developers/verify

Authentication

Send your free API key in the x-api-key header. Get one at https://poliergaleio.com/profile (free account). Anonymous calls work without a key on the stateless calculators (10/min, 50/day, 200/week); the free key tier is 60/min, 1,000/day, 5,000/week and unlocks saved-calculation tools.

Claude Desktop / Claude Code (MCP)

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), then restart Claude Desktop:

{
  "mcpServers": {
    "poliergaleio": {
      "url": "https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http poliergaleio https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/mcp

Cursor (MCP)

{
  "mcpServers": {
    "poliergaleio": {
      "url": "https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/mcp"
    }
  }
}

ChatGPT (Actions / MCP)

Use the OpenAPI spec at https://poliergaleio.com/poliergaleio-openapi.json as the Action schema, with API-key authentication in the x-api-key header.

Gemini (REST / function calling)

Call any tool with plain HTTP POST. Example:

curl -s -X POST https://gpkpjfdlbsuyevfdsnbq.supabase.co/functions/v1/public-api/tools/calculate_cyprus_income_tax \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"salaryIncome": 45000, "legislationVersion": "2026"}'

Available tools

Tool	What it does
`calculate_cyprus_income_tax`	Computes Cyprus personal income tax, GESY (National Health System) contributions, social insurance, and net (take-home) salary.
`calculate_cyprus_state_pension`	Estimates the Cyprus state (contributory) pension amount at retirement based on accumulated insurance units and contribution history.
`run_retirement_stress_test`	Runs a deterministic projection plus Monte Carlo simulation of a retirement savings plan to estimate the probability of not running out of money.
`calculate_cyprus_unemployment_benefit`	Calculates Cyprus unemployment benefit entitlement (weekly/monthly amount and duration) from recent insurable earnings and household circumstances.
`get_pension_reference_data`	Returns official Cyprus Social Insurance reference tables for a given year.
`parse_pension_statement`	Extracts structured contribution history from pasted Cyprus Social Insurance Services pension statement text.
`list_saved_calculations` 🔑	Lists metadata of an authenticated user's saved calculations by calculator type.
`load_saved_calculation` 🔑	Loads one saved calculation belonging to the authenticated API key's user.

🔑 requires an API key; all other tools work anonymously at the lower rate limits.

Downloads

Προγραμματιστές & AI Agents — Δημόσιο API & MCP Server | PoliErgaleio

Δωρεάν MCP server και REST API για υπολογισμούς φόρου εισοδήματος, κρατικής σύνταξης και επιδόματος ανεργίας Κύπρου. Οδηγοί για Claude Desktop, ChatGPT, Gemini και Cursor.