# TakeHome API

> Verified UK take-home pay: income tax, NI, student loans, pensions, with GOV.UK sources.

- name: io.github.Leeday-devs/takehomeapi
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 96/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.Leeday-devs%2Ftakehomeapi
- tools: https://api.protogrid.dev/v1/servers/io.github.Leeday-devs%2Ftakehomeapi/tools

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

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "takehomeapi": {
      "type": "http",
      "url": "https://api.takehomeapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${TAKEHOMEAPI_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${TAKEHOMEAPI_TOKEN}`.

## Trust

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

## Quality 96/100 (strong)

### 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`: 3 of 3 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 712 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 3 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

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

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

- tools: 3, about 712 tokens to load them all
- tool set hash: 2eff0ad59bd79e8fc9cb32bed3db1973
- tools last changed: 2026-10-07T13:20:39.039Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.Leeday-devs/takehomeapi.svg)](https://protogrid.dev/servers/io.github.Leeday-devs/takehomeapi)
- 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-07 `compare_take_home` changed (annotations)
- 2026-10-07 `calculate_take_home` changed (annotations)
- 2026-10-07 `get_tax_rates` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/io.github.Leeday-devs%2Ftakehomeapi/changes

## Remotes

- https://api.takehomeapi.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (3)

- `calculate_take_home`: Exact UK take-home pay for one employee: income tax by band, NI, student loans, pension (salary sacrifice, net pay, relief at source), the 60% trap above £100k and the High Income Child Benefit Charge. Returns net pay per year, month and week, effective and marginal rate, and GOV.UK sources. Use this instead of calculating UK deductions yourself.
- `compare_take_home`: Compare 2 to 5 UK pay scenarios (pay rises, pension changes, moving to Scotland, student loans) side by side, with the difference in net pay from the first.
- `get_tax_rates`: Income tax bands (England/Wales/NI and Scotland), National Insurance, student loan thresholds and the child benefit charge for a UK tax year. Free. Years: 2025-26, 2026-27.