UK Income Tax and Salary
UK income tax and take-home pay 2025/26 and 2026/27: Scottish bands, NI, student loans, 60% trap.
Should I use this
Quality & Safety
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": {
"uk-income-tax-salary-mcp": {
"url": "https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp"
}
}
}Remote endpoints
https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢calculate_uk_take_home(gross_salary, tax_year, region, tax_code, pension_method, ...)
Calculates UK take-home pay for an employee in tax year 2025/26 or 2026/27 from HMRC's published rates: income tax by band (England, Wales and NI, or the six Scottish bands incl. the 2026/27 Scottish starter and basic bands), employee Class 1 National Insurance (8% / 2%), student loan repayments (Plan 1, 2, 4, 5 and Postgraduate, with 2026/27 thresholds), and pension by salary sacrifice or relief at source. Applies the Personal Allowance taper above £100,000 (£1 per £2, the 60% trap) and reads tax codes such as 1257L, S1257L, K475, BR and D0. Returns net pay a year, a month and a week. Figures copied from gov.uk and HMRC in Oct 2026.
Input Schema
{
"type": "object",
"properties": {
"gross_salary": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Annual gross salary in pounds (GBP), before any deductions."
},
"tax_year": {
"type": "string",
"enum": [
"2025/26",
"2026/27"
],
"description": "UK tax year, 6 April to 5 April. 2025/26 or 2026/27 (default 2026/27)."
},
"region": {
"type": "string",
"enum": [
"england",
"wales",
"northern_ireland",
"england_wales_ni",
"scotland"
],
"description": "Where you live for tax. england, wales, northern_ireland (same bands) or scotland (six Scottish bands). Default england, or taken from an S or C tax code."
},
"tax_code": {
"type": "string",
"maxLength": 16,
"description": "PAYE tax code, default 1257L. Supports nnnnL/M/N/T, S and C prefixes, K codes, BR, D0, D1, SBR, SD0-SD3, 0T, NT and W1/M1/X suffixes."
},
"pension_method": {
"type": "string",
"enum": [
"none",
"relief_at_source",
"salary_sacrifice"
],
"description": "relief_at_source (you pay 80%, provider adds 20%, higher-rate relief claimed back) or salary_sacrifice (cuts pay before tax, NI and student loan). Default salary_sacrifice if a pension is given."
},
"pension_percent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Employee pension contribution as a percent of gross salary, e.g. 5. For relief at source this is the gross (grossed-up) contribution."
},
"pension_amount": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Employee pension contribution in pounds a year (gross). Use this OR pension_percent."
},
"student_loan_plans": {
"type": "array",
"items": {
"type": "string",
"enum": [
"plan_1",
"plan_2",
"plan_4",
"plan_5",
"postgraduate"
]
},
"maxItems": 5,
"description": "Student loan plans you repay: plan_1, plan_2, plan_4 (Scotland), plan_5, postgraduate. Several are allowed, as gov.uk describes."
},
"ni_category": {
"type": "string",
"enum": [
"A",
"B",
"C",
"H",
"J",
"M",
"V",
"Z"
],
"description": "National Insurance category letter, default A. C = over State Pension age (no employee NI)."
}
},
"required": [
"gross_salary"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_uk_tax_bands(tax_year, region)
Returns the official UK income tax bands for 2025/26 or 2026/27, for England, Wales and Northern Ireland or for Scotland (starter 19%, basic 20%, intermediate 21%, higher 42%, advanced 45%, top 48%), both as taxable-income bands from HMRC's employer tables and as gross-salary bands with the standard £12,570 allowance. Also returns the £100,000 allowance taper, Class 1 NI thresholds and employee rates by category letter, and student loan thresholds for each plan. A figure that is not published is marked unannounced, never guessed. Copied from gov.uk and HMRC in Oct 2026.
Input Schema
{
"type": "object",
"properties": {
"tax_year": {
"type": "string",
"enum": [
"2025/26",
"2026/27"
],
"description": "UK tax year: 2025/26 or 2026/27."
},
"region": {
"type": "string",
"enum": [
"england",
"wales",
"northern_ireland",
"england_wales_ni",
"scotland"
],
"description": "england, wales, northern_ireland, england_wales_ni or scotland."
}
},
"required": [
"tax_year",
"region"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_salaries(salaries, tax_year, region, tax_code, pension_method, ...)
Compares 1 to 5 UK gross salaries after income tax, National Insurance, student loan and pension for 2025/26 or 2026/27, with the same region, tax code and options for each. Shows net pay a year, month and week, effective and marginal rates, and how much of each pay rise you keep compared with the first salary. Shows when a rise lands in the £100,000 to £125,140 Personal Allowance taper (60% in England, 69.5% in Scotland in 2026/27 with NI). Uses HMRC 2025/26 and 2026/27 rates fetched in Oct 2026.
Input Schema
{
"type": "object",
"properties": {
"salaries": {
"type": "array",
"items": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Annual gross salary in pounds (GBP), before any deductions."
},
"minItems": 1,
"maxItems": 5,
"description": "1 to 5 annual gross salaries in pounds. The first is the baseline."
},
"tax_year": {
"type": "string",
"enum": [
"2025/26",
"2026/27"
],
"description": "UK tax year, 6 April to 5 April. 2025/26 or 2026/27 (default 2026/27)."
},
"region": {
"type": "string",
"enum": [
"england",
"wales",
"northern_ireland",
"england_wales_ni",
"scotland"
],
"description": "Where you live for tax. england, wales, northern_ireland (same bands) or scotland (six Scottish bands). Default england, or taken from an S or C tax code."
},
"tax_code": {
"type": "string",
"maxLength": 16,
"description": "PAYE tax code, default 1257L. Supports nnnnL/M/N/T, S and C prefixes, K codes, BR, D0, D1, SBR, SD0-SD3, 0T, NT and W1/M1/X suffixes."
},
"pension_method": {
"type": "string",
"enum": [
"none",
"relief_at_source",
"salary_sacrifice"
],
"description": "relief_at_source (you pay 80%, provider adds 20%, higher-rate relief claimed back) or salary_sacrifice (cuts pay before tax, NI and student loan). Default salary_sacrifice if a pension is given."
},
"pension_percent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Employee pension contribution as a percent of gross salary, e.g. 5. For relief at source this is the gross (grossed-up) contribution."
},
"pension_amount": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Employee pension contribution in pounds a year (gross). Use this OR pension_percent."
},
"student_loan_plans": {
"type": "array",
"items": {
"type": "string",
"enum": [
"plan_1",
"plan_2",
"plan_4",
"plan_5",
"postgraduate"
]
},
"maxItems": 5,
"description": "Student loan plans you repay: plan_1, plan_2, plan_4 (Scotland), plan_5, postgraduate. Several are allowed, as gov.uk describes."
},
"ni_category": {
"type": "string",
"enum": [
"A",
"B",
"C",
"H",
"J",
"M",
"V",
"Z"
],
"description": "National Insurance category letter, default A. C = over State Pension age (no employee NI)."
}
},
"required": [
"salaries"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢marginal_rate_at_income(gross_salary, tax_year, region, tax_code, pension_method, ...)
Returns the true UK marginal rate on the next pounds of salary in 2025/26 or 2026/27: income tax band rate, employee NI and student loan together, plus the Personal Allowance taper between £100,000 and £125,140 that makes it 60% plus NI in England, Wales and NI and 67.5% plus NI in Scotland's advanced band. Handles salary sacrifice, relief at source, Scottish bands and tax codes. Measured as the change in deductions over the next `step` pounds (default £100). Rates from gov.uk and HMRC, fetched Oct 2026.
Input Schema
{
"type": "object",
"properties": {
"gross_salary": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Annual gross salary in pounds (GBP), before any deductions."
},
"tax_year": {
"type": "string",
"enum": [
"2025/26",
"2026/27"
],
"description": "UK tax year, 6 April to 5 April. 2025/26 or 2026/27 (default 2026/27)."
},
"region": {
"type": "string",
"enum": [
"england",
"wales",
"northern_ireland",
"england_wales_ni",
"scotland"
],
"description": "Where you live for tax. england, wales, northern_ireland (same bands) or scotland (six Scottish bands). Default england, or taken from an S or C tax code."
},
"tax_code": {
"type": "string",
"maxLength": 16,
"description": "PAYE tax code, default 1257L. Supports nnnnL/M/N/T, S and C prefixes, K codes, BR, D0, D1, SBR, SD0-SD3, 0T, NT and W1/M1/X suffixes."
},
"pension_method": {
"type": "string",
"enum": [
"none",
"relief_at_source",
"salary_sacrifice"
],
"description": "relief_at_source (you pay 80%, provider adds 20%, higher-rate relief claimed back) or salary_sacrifice (cuts pay before tax, NI and student loan). Default salary_sacrifice if a pension is given."
},
"pension_percent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Employee pension contribution as a percent of gross salary, e.g. 5. For relief at source this is the gross (grossed-up) contribution."
},
"pension_amount": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "Employee pension contribution in pounds a year (gross). Use this OR pension_percent."
},
"student_loan_plans": {
"type": "array",
"items": {
"type": "string",
"enum": [
"plan_1",
"plan_2",
"plan_4",
"plan_5",
"postgraduate"
]
},
"maxItems": 5,
"description": "Student loan plans you repay: plan_1, plan_2, plan_4 (Scotland), plan_5, postgraduate. Several are allowed, as gov.uk describes."
},
"ni_category": {
"type": "string",
"enum": [
"A",
"B",
"C",
"H",
"J",
"M",
"V",
"Z"
],
"description": "National Insurance category letter, default A. C = over State Pension age (no employee NI)."
},
"step": {
"type": "number",
"minimum": 1,
"maximum": 10000,
"description": "Size of the pay rise to measure over, in pounds (default 100)."
}
},
"required": [
"gross_salary"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence