TakeHome API
Verified UK take-home pay: income tax, NI, student loans, pensions, with GOV.UK sources.
Should I use this
Quality & Safety
Findings (2)
- LOWTool 'get_tax_rates' description lacks action verbin get_tax_rates
- LOWTool 'calculate_take_home' description lacks action verbin calculate_take_home
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"takehomeapi": {
"url": "https://api.takehomeapi.com/mcp"
}
}
}Remote endpoints
https://api.takehomeapi.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢get_tax_rates(taxYear)
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.
Input Schema
{
"type": "object",
"properties": {
"taxYear": {
"type": "string",
"enum": [
"2025-26",
"2026-27"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢calculate_take_home(grossSalary, taxYear, region, studentLoans, pension, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"grossSalary": {
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"taxYear": {
"type": "string",
"enum": [
"2025-26",
"2026-27"
]
},
"region": {
"type": "string",
"enum": [
"rUK",
"scotland",
"england",
"wales",
"northern-ireland",
"ni"
]
},
"studentLoans": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"plan1",
"plan2",
"plan4",
"plan5",
"postgrad"
]
}
},
"pension": {
"type": "object",
"properties": {
"percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"method": {
"type": "string",
"enum": [
"salary_sacrifice",
"net_pay",
"relief_at_source"
]
}
},
"required": [
"percent",
"method"
],
"additionalProperties": false
},
"childBenefitAnnual": {
"type": "number",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"grossSalary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢compare_take_home(scenarios)
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.
Input Schema
{
"type": "object",
"properties": {
"scenarios": {
"minItems": 2,
"maxItems": 5,
"type": "array",
"items": {
"type": "object",
"properties": {
"grossSalary": {
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"taxYear": {
"type": "string",
"enum": [
"2025-26",
"2026-27"
]
},
"region": {
"type": "string",
"enum": [
"rUK",
"scotland",
"england",
"wales",
"northern-ireland",
"ni"
]
},
"studentLoans": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"plan1",
"plan2",
"plan4",
"plan5",
"postgrad"
]
}
},
"pension": {
"type": "object",
"properties": {
"percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"method": {
"type": "string",
"enum": [
"salary_sacrifice",
"net_pay",
"relief_at_source"
]
}
},
"required": [
"percent",
"method"
],
"additionalProperties": false
},
"childBenefitAnnual": {
"type": "number",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"grossSalary"
],
"additionalProperties": false
}
}
},
"required": [
"scenarios"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence