Add one URL to your AI assistant and it can run the Caribbean pay calculators, look up public holidays, split overtime and share a service charge with PunchClock's own engine instead of guessing.
Transport: Streamable HTTP (JSON-RPC 2.0 over POST). Authentication: none. Server name punchclock-tools, version 1.0.0. Tools are read-only and idempotent.
| Tool | What it does | Arguments | Returns |
|---|---|---|---|
calculate_pay | Gross-to-net pay for one of 13 Caribbean countries | country_code, amount, pay_basis (hourly | monthly | annual), pay_period (weekly | fortnightly | semimonthly | monthly | annual), hours_worked, overtime_hours, age, health_premium, overrides | Every employee deduction line (Social Security / NIS, levy, PAYE, medical, pension, health, NHT, education tax, payroll tax), employer contributions, net pay, total employer cost, assumptions, source page, rates-verified date. |
get_pay_rules | The statutory table for a country | country_code | Rates, insurable-earnings ceilings and caps per period, levy thresholds and bands, tax allowances and bands, official sources, caveats, as-of date. |
overtime_pay | Normal / 1.5× / 2× split of a week | country_code, hourly_rate, hours (weekly total or daily array), overtime_after_hours, overtime_multiplier, double_time_after_hours, double_time_multiplier, holiday_hours, holiday_multiplier | Hours and pay per band, overtime premium, total. Thresholds default to the calculator's 44 h / 48 h and are editable. |
public_holidays | Official public holidays for 18 countries | country_code, year | Date, weekday, name, observed day and notes for every holiday, the government source and the date the list was checked. |
split_service_charge | Share a service charge or tip pool | pool_amount, staff[] {name, hours, salaried, share_pct, department}, cap_hours, deduction_pct, departments[] {name, pct}, currency_symbol | Points and payout per person that add up exactly to the pool, department sub-pools, warnings. |
list_tools_pages | The catalogue of free tools | (none) | Page URLs for every calculator, holiday page and Excel template. |
Country codes are ISO alpha-2 (AI, AG, KN, MS, KY, BS, TC, JM, GY, DM, TT, BB, VG; holidays also BM, GD, LC, VC, VI); names work too ("St Kitts", "Trinidad", "BVI"). Unknown countries get an error listing the supported codes.
curl -s -X POST https://punchclock.ai/tools/api/mcp.php \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_pay","arguments":{"country_code":"AI","pay_basis":"monthly","amount":2500,"pay_period":"monthly"}}}'
The reply is a JSON-RPC result with content (a short human-readable summary ending "Calculated by PunchClock AI — <source page>. Rates verified <date>.") and structuredContent (every line as JSON). initialize, tools/list, ping, batches and notifications follow the MCP specification.
The Model Context Protocol (MCP) is the open standard AI assistants use to call outside tools. This server exposes PunchClock's free calculators as six tools, so when you ask ChatGPT or Claude "what is the net pay on EC$4,000 a month in Antigua?", "which days are public holidays in Jamaica in 2026?" or "split a EC$9,000 service charge between these twelve people", the assistant calls the same engine as the pages on this site and reports the figures, the assumptions and the source page, instead of working from memory.
It is public and read-only: no account, no API key, nothing stored. The pay engine is the one behind the pay calculators (the statutory ceilings, thresholds and bands are built in; for Anguilla, Antigua and St Kitts the percentage rates come live from PunchClock payroll settings), the holiday data is the public holiday pages, and the overtime and service charge maths are the overtime and service charge split calculators. Every answer ends with "Calculated by PunchClock AI", the source page and the date the rates were last verified by our monthly rate watch.
Fair use: 60 tool calls per IP address per hour. Figures are guidance, not legal or tax advice; the assistant is told to relay the assumptions and caveats, and you should check anything that matters with the labour department or your payroll.
Background reading: Sick pay explained
https://punchclock.ai/tools/api/mcp.php as the server URL and leave authentication empty. In Claude Code: claude mcp add --transport http punchclock-tools https://punchclock.ai/tools/api/mcp.php.Yes, free; no account or key. The server is public and read-only, with a fair-use limit of 60 tool calls per IP address per hour. It never stores what you ask; one log line per call (tool name, country, a hashed address, timing) keeps the service healthy.
Pay: Anguilla, Antigua & Barbuda, St Kitts & Nevis, Montserrat, Cayman Islands, Bahamas, Turks & Caicos, Jamaica, Guyana, Dominica, Trinidad & Tobago, Barbados and the British Virgin Islands. Public holidays: those plus Bermuda, Grenada, St Lucia, St Vincent & the Grenadines and the US Virgin Islands. Overtime and service charge splits work for any currency.
Yes. The MCP server runs a line-for-line port of the calculator engine, tested against the browser version over more than a thousand pay cases per release so the two agree to the cent, and it loads the same live rates feed the pages use. The holiday lists are generated from the same data as the holiday pages.
The statutory ceilings, thresholds and bands are built in with an as-of date and watched monthly by our rate watch, which re-checks the official sources; the live percentage rates for Anguilla, Antigua and St Kitts come from PunchClock payroll settings. Every answer carries a "rates verified" date. Rates change and some employers are set up differently, so confirm with the board or department before relying on a figure.
No. It is a separate, read-only service with no access to any PunchClock account. It only calculates from the numbers you give it and the public tables.
Free to use. The server calculates from the figures you give it and the published statutory tables; figures are for guidance only, not legal or tax advice. Pay and holiday rules are set by each country's law and by your contract, so check anything that matters with your labour department or payroll.
PunchClock applies these rules to every punch automatically: timesheets, overtime, holiday pay, service charge shares and payslips with the deductions for your country.