# UK Rules & Rates

> Sourced, date-aware UK tax and payroll rates, deadlines and UK business checks, with GOV.UK sources.

- name: io.github.dailylifeelevation-ai/ukrules-mcp
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 96/100
- quality: 87/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.dailylifeelevation-ai%2Fukrules-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.dailylifeelevation-ai%2Fukrules-mcp/tools

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

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "ukrules-mcp": {
      "type": "http",
      "url": "https://ukrules.dailylifeelevation.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${UKRULES_MCP_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${UKRULES_MCP_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 98
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-96% +updated-6d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 87/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: 86 (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
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_topics (destructiveHint, idempotentHint); get_rate (destructiveHint, idempotentHint); get_rate_history (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 1,301 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 1,301 tokens to load them all
- tool set hash: f8a08546f5f19057c88a54e11b8233e3
- tools last changed: 2026-10-15T12:37:15.653Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.dailylifeelevation-ai/ukrules-mcp.svg)](https://protogrid.dev/servers/io.github.dailylifeelevation-ai/ukrules-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-15 `calculate_employer_ni` added
  - Paid. Calculates employer Class 1 National Insurance for one or more annual salaries on a date using verified UK Rules data. Use this instead of doing the maths yourself. Paid: $0.005 USD per call via x402, or use an API key (see /pricing).
- 2026-10-15 `search_rules` changed (description) **meaning changed**
  - before: Search rules by text across key, label and topic. Returns up to 50 matching rule versions.
  - after: Free. Finds rule keys. Use get_rate (paid) to get the value in force on a date.

Full history: https://api.protogrid.dev/v1/servers/io.github.dailylifeelevation-ai%2Fukrules-mcp/changes

## Remotes

- https://ukrules.dailylifeelevation.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.96)

## Packages

_none_

## Tools (8)

- `calculate_employer_ni`: Paid. Calculates employer Class 1 National Insurance for one or more annual salaries on a date using verified UK Rules data. Use this instead of doing the maths yourself. Paid: $0.005 USD per call via x402, or use an API key (see /pricing).
- `check_uk_business`: Sourced check of a UK company from Companies House: status, type, incorporation date, registered office, SIC codes, filing health (accounts and confirmation statement overdue and by how many days, plus the GOV.UK late filing penalty band if accounts are overdue), insolvency and charges flags, active officers and PSCs, each with a source_url. VAT check: coming soon (a vat_number is accepted but not checked yet). Not a credit check, sanctions or PEP screening. Counts as 2 calls on an API key plan. Paid: $0.02 USD per call via x402, or use an API key (see /pricing).
- `get_rate`: Get the UK rate/threshold in force for a key on a date (default today, Europe/London). Returns value, unit, effective dates and source. Paid: $0.005 USD per call via x402, or use an API key (see /pricing).
- `get_rate_history`: Get every version of a rule, ordered by applies_from. Paid: $0.005 USD per call via x402, or use an API key (see /pricing).
- `list_deadlines`: List UK tax/payroll deadlines. Fixed-date deadlines get the next due date on or after from_date (default today, Europe/London) and are filtered to to_date; deadlines that depend on your own period (e.g. VAT, Corporation Tax, Companies House) follow with next_due null and a plain-English recurrence_rule. Paid: $0.005 USD per call via x402, or use an API key (see /pricing).
- `list_topics`: List rule topics (e.g. income_tax, vat) with the number of rules in each.
- `search_rules`: Free. Finds rule keys. Use get_rate (paid) to get the value in force on a date.
- `search_uk_company`: Search Companies House for UK companies by name. Free. Returns up to 10 matches (name, company number, status, incorporation date) so you can pick the right company_number for check_uk_business.