HR & Payroll Rules Oracle
Server Details
UAE and Saudi gratuity, leave, notice, overtime and sick-pay arithmetic with cited articles.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each tool targets a clearly distinct HR/payroll calculation or rule-retrieval purpose: leave, gratuity, notice, overtime, probation, sick pay, wage breakdown, and rule listing. Although wage_breakdown is a supporting utility, its purpose is unambiguous and does not overlap with the entitlement calculators.
All tool names use snake_case and are descriptively domain-specific, which makes them predictable. The only minor deviation is that list_rules uses a verb_noun form while the other seven tools use noun-phrase names.
Eight tools is well within the appropriate range for an HR and payroll rules oracle. Each tool covers a distinct, meaningful calculation or reference function, so the surface does not feel padded or thin.
The set covers the core payroll and employment-law calculations for UAE and Saudi Arabia, including leave, end-of-service, notice, overtime, probation, sick pay, and wage bases. Some adjacent entitlements such as maternity/paternity leave or public-holiday rules are not explicitly represented, but list_rules partly mitigates this gap.
Available Tools
8 toolsannual_leave_entitlementAnnual leave accrued, balance and encashmentARead-onlyIdempotentInspect
Accrued annual leave at a date (UAE Art. 29: 30 days/year, 2 days/month between 6 and 12 months; Saudi Art. 109: 21 days, 30 after 5 years), balance after days taken, and encashment value at the legal basis wage. Example: country 'AE', start_date '2024-01-15', as_of_date '2026-10-31', taken_days 20, basic_monthly_wage 6000. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: country (required), as_of_date (required), start_date (required), taken_days, +2 more. Returns: object
end_of_serviceEnd-of-service gratuity / awardARead-onlyIdempotentInspect
Compute the end-of-service gratuity (UAE Art. 51: 21 days' basic wage per year for 5 years then 30, capped at 2 years' wage, pro rata, unpaid days excluded) or the Saudi award (Art. 84/85/87: half a month's actual wage per year for 5 years then a full month, resignation fractions ⅓/⅔/full). Returns the step-by-step computation. Example: country 'AE', start_date '2019-03-01', end_date '2026-10-31', basic_monthly_wage 8000, termination 'resignation'. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: country (required), end_date (required), start_date (required), basic_monthly_wage (required), +4 more. Returns: object
list_rulesRule tables with articles and sourcesARead-onlyIdempotentInspect
The covered countries, or one country's full rule table (articles, figures, effective dates, scope notes, official source URLs). Free. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: country. Returns: object
notice_periodNotice period and pay in lieuARead-onlyIdempotentInspect
Legal notice period for a termination (UAE Art. 43: 30–90 days as agreed; probation Art. 9: 14 days employer / 30 or 14 days employee; Saudi Art. 75: 60 days employer, 30 days employee from 19 Feb 2025), the date notice ends, and pay in lieu. Example: country 'SA', party 'employee', on_date '2026-11-01', monthly_wage 9000. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: party (required), country (required), on_date, contract, +4 more. Returns: object
overtime_payOvertime payARead-onlyIdempotentInspect
Overtime at the legal uplift on the basic hourly wage (UAE Art. 19: +25%, +50% at night 22:00–04:00 or on the rest day; Saudi Art. 107: +50%). Example: country 'AE', basic_monthly_wage 6000, hours 10, kind 'night'. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: hours (required), country (required), basic_monthly_wage (required), kind. Returns: object
probation_rulesProbation end date and noticesARead-onlyIdempotentInspect
Probation length allowed (UAE Art. 9: up to 6 months; Saudi Art. 53: up to 180 days from 19 Feb 2025, 90 before), its end date and the notice rules that apply inside it. Example: country 'AE', start_date '2026-11-01', agreed_days 90. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: country (required), start_date (required), agreed_days. Returns: object
sick_leave_paySick-leave pay by tierARead-onlyIdempotentInspect
Pay for a number of sick days under the tiered rules (UAE Art. 31: 15 full, 30 half, 45 unpaid, none during probation; Saudi Art. 117: 30 full, 60 at 75%, 30 unpaid). Example: country 'AE', days 40, monthly_wage 9000. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: days (required), country (required), monthly_wage (required), in_probation. Returns: object
wage_breakdownDaily and hourly wage conventionsARead-onlyIdempotentInspect
Daily and hourly basic/total wages under the country's convention (monthly ÷ 30, ÷ 8 hours) with a note on which basis each entitlement uses. Example: country 'AE', basic_monthly_wage 6000, total_monthly_wage 10000. Response: result with legal_basis (article) and explanation[] steps, data_confidence (high = official text; medium = translation or recent amendment via secondary source), estimated_items[], sources[] (law URLs), data_version, warnings[] and a not-legal-advice disclaimer.
Inputs: country (required), basic_monthly_wage (required), total_monthly_wage. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Jordan & GCC labour-law, tax and finance calculators for AI agents — 36 deterministic tools.
Gulf end-of-service gratuity, salary, GOSI, VAT, zakat + 160 more exact calculators. Lean tool list.
Mid-East govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 9 countries; UAE free.
Read-only UAE legal information: official routes, practical guides, free tools and FAQs.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceCalculates end-of-service gratuity/severance for multiple countries (AE, SA, QA, etc.) via a stateless JSON API and MCP tool.-
- AlicenseNot gradedqualityBmaintenanceComputes Japanese payroll, social insurance, and labour law obligations—such as premiums, withholding tax, and minimum wage—citing the statute each answer relies on, enabling auditable calculations through an AI assistant.3MIT
- AlicenseAqualityCmaintenanceTaiwan statutory payroll calculation — labor & health insurance, labor pension, 2nd-gen NHI supplementary premium, income-tax withholding, and old-age benefits. Sourced from official gazettes, verified against official sample data.92MIT
- AlicenseNot gradedqualityCmaintenanceEnables calculating U.S. DOL WH-347 certified payroll columns 5–9, fringe benefit 6B reconciliation, and PTO accrual balances from policy, hire-date, holiday, and request inputs.49 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.