# HR & Payroll Rules Oracle

> UAE and Saudi gratuity, leave, notice, overtime and sick-pay arithmetic with cited articles.

- name: tech.noahsarch/hr-payroll-oracle
- version: 0.1.1
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 94/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/tech.noahsarch%2Fhr-payroll-oracle
- tools: https://api.protogrid.dev/v1/servers/tech.noahsarch%2Fhr-payroll-oracle/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "hr-payroll-oracle": {
      "type": "http",
      "url": "https://hr.noahsarch.tech/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

- hygiene: 80
- liveness: 97
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-93% +updated-7d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 94/100 (new)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,898 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 2,898 tokens to load them all
- tool set hash: 0db8a3f0441d9875b3ca6ca59243c64f
- badge: [![protogrid quality](https://protogrid.dev/badge/tech.noahsarch/hr-payroll-oracle.svg)](https://protogrid.dev/servers/tech.noahsarch/hr-payroll-oracle)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://hr.noahsarch.tech/mcp (streamable-http, auth none, reachable true, uptime30d 0.9259259)

## Packages

_none_

## Tools (8)

- `annual_leave_entitlement`: 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.
- `end_of_service`: 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.
- `list_rules`: 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.
- `notice_period`: 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.
- `overtime_pay`: 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.
- `probation_rules`: 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.
- `sick_leave_pay`: 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.
- `wage_breakdown`: 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.