uk-income-tax-salary-mcp
Calculate UK income tax, National Insurance, student loan, pension and take-home pay for 2025/26 and 2026/27.
Calculate annual, monthly and weekly net pay from gross salary using region, tax code, NI category, pension method/amount and student loan plans.
Retrieve official income tax bands and thresholds, including Scottish bands, allowance taper, NI thresholds/rates and student loan thresholds.
Compare 1–5 salaries side by side with net pay, effective/marginal rates and how much of a rise you keep.
Measure the true marginal rate at a given income, including NI, student loan and the £100,000–£125,140 Personal Allowance taper.
Use the hosted MCP endpoint with no sign-in/token, or run locally via npx.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@uk-income-tax-salary-mcp What's my monthly take-home on £48,000 in Manchester with a Plan 2 loan?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
uk-income-tax-salary-mcp
An MCP server that works out UK income tax and take-home pay on a salary for 2025/26 and 2026/27, with the Scottish bands, National Insurance, student loans, pension and the 60% tax trap, using HMRC's published rates.
Hosted endpoint, no sign-in and no token:
https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcpTools
Tool | What it does |
| Net pay a year, a month and a week. Income tax by band (England, Wales and NI, or the six Scottish bands), employee Class 1 NI, student loan (Plan 1, 2, 4, 5, Postgraduate), pension by salary sacrifice or relief at source, tax codes (1257L, S1257L, K475, BR, D0, SD1, 0T, NT) and the Personal Allowance taper above £100,000. |
| Official bands for a tax year and region, as taxable-income bands and as gross-salary bands. Also the allowance taper, NI thresholds and rates by category letter, and student loan thresholds. |
| Up to 5 salaries side by side: net pay, effective and marginal rates, and how much of each rise you keep. |
| The true marginal rate on the next pounds of pay: income tax, NI and student loan together, including the £100,000 to £125,140 taper. |
Every result has structured JSON, a plain-English summary, as_of, source (the gov.uk or HMRC page) and more (a calculator page on ukmoneycalc.com).
Related MCP server: statetakehome-mcp
What it knows that your model does not
The 2026/27 Scottish bands. The starter band now runs to £16,537 and the basic band to £29,526 (2025/26: £15,397 and £27,491).
The 2026/27 student loan thresholds: Plan 1 £26,900, Plan 2 £29,385, Plan 4 £33,795, Postgraduate £21,000, and the first Plan 5 threshold of £25,000. Plan 5 has no threshold in 2025/26.
The 2026/27 NI lower earnings limit of £6,708 and the 8% / 2% employee rates by category letter.
The taper takes £1 of allowance for every complete £2 over £100,000. That makes the marginal rate 62% in England with NI, and 69.5% in Scotland's 45% advanced band.
With relief at source you pay 80% and claim the rest above 20% yourself, and the grossed-up contribution lowers adjusted net income for the taper. Salary sacrifice also cuts NI and student loan.
Several student loan plans repay 9% over the lowest threshold, plus 6% over the Postgraduate threshold, as gov.uk describes.
Install
Claude.ai custom connector or ChatGPT developer mode
Add a custom connector and paste the URL. No token is needed.
https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcpClaude Code
claude mcp add --transport http uk-income-tax https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcpOr run it locally:
claude mcp add uk-income-tax -- npx -y uk-income-tax-salary-mcpClaude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"uk-income-tax": {
"command": "npx",
"args": ["-y", "uk-income-tax-salary-mcp"]
}
}
}Cursor
Add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"uk-income-tax": {
"url": "https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp"
}
}
}VS Code
Add this to .vscode/mcp.json:
{
"servers": {
"uk-income-tax": {
"type": "http",
"url": "https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp"
}
}
}Node 20 or newer is needed for the local npx version.
Example prompts
"I earn £48,000 in Manchester with a Plan 2 student loan. What is my take-home pay a month in 2026/27?"
"I live in Edinburgh and earn £52,000. How much income tax do I pay this year, band by band?"
"My salary goes from £98,000 to £112,000. How much of the rise do I keep, and how much salary sacrifice gets me back under £100,000?"
"What is my marginal tax rate at £115,000 with a 5% relief at source pension?"
"Compare £35,000, £45,000 and £60,000 after tax in Scotland."
Data sources
All numbers come from gov.uk and HMRC pages fetched on 2026-10-30: Rates and thresholds for employers 2025 to 2026 and 2026 to 2027, Income Tax rates and Personal Allowances, Income Tax in Scotland, National Insurance rates and categories, Repaying your student loan, Tax on your private pension, Adjusted net income and Tax codes. See DATA_SOURCES.md for each item and URL.
Limitations
Results are estimates, not tax advice.
It works on annual figures. Payroll works per pay period, so a payslip can differ by a few pounds, for example where monthly NI and student loan thresholds are rounded.
One employment and salary income only. Savings, dividends, benefits in kind, the High Income Child Benefit Charge, Marriage Allowance transfers and Blind Person's Allowance are not modelled beyond the tax code you give.
The pension percent is applied to the whole gross salary, not to qualifying earnings. Employer contributions are not included.
Net pay arrangement pensions are not a separate option. Use salary_sacrifice for the tax effect, but note that net pay does not cut NI.
K codes do not apply the 50% overriding limit.
Tax years before 2025/26 are not included.
More
Calculators for people: ukmoneycalc.com.
Part of the Zovo MCP collection: https://mcp.zovo.one
Development
npm install
npm run build
npm testsrc/core.ts holds all the rules and has no I/O. src/stdio.ts is the local entry and src/worker.ts is the Cloudflare Worker entry. Both use the same tool registry in src/tools.ts.
License
MIT
More data servers from the same author
Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.
server | tools | hosted URL |
convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature |
| |
calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary |
| |
get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units |
| |
search_lakes, get_lake_level, get_lake_history, compare_lakes |
| |
get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage |
| |
calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility |
| |
calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets |
| |
list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date |
| |
calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk |
| |
get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap |
| |
get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite |
| |
calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit |
| |
get_exemption_amounts, calculate_estate_tax, check_gift, compare_years |
| |
lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition |
| |
get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years |
| |
calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment |
| |
calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates |
| |
find_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surface |
| |
calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility |
|
The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one
More from zovo
All free zovo VS Code extensions - file viewers, database clients, formatters. Offline, no telemetry, no sign-up.
Full MCP server catalogue - local-first MCP servers for back-office work: invoices, VAT, PDFs, spreadsheets, payroll.
Hosted no-install MCP endpoints - paste a URL in Claude / Cursor, nothing to install.
Available Tools
4 toolscalculate_uk_take_homeUK take-home payARead-onlyIdempotentInspect
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.
Inputs: gross_salary (required), region, tax_code, tax_year, +5 more.
compare_salariesCompare UK salaries after taxARead-onlyIdempotentInspect
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.
Inputs: salaries (required), region, tax_code, tax_year, +5 more.
get_uk_tax_bandsUK income tax bands and thresholdsARead-onlyIdempotentInspect
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.
Inputs: region (required), tax_year (required).
marginal_rate_at_incomeUK marginal tax rate at a salaryARead-onlyIdempotentInspect
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.
Inputs: gross_salary (required), step, region, tax_code, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The four tools have reasonably distinct outputs: raw band/threshold reference data, a point-in-time marginal rate, a full take-home breakdown, and a multi-salary comparison. However, calculate_uk_take_home, marginal_rate_at_income, and compare_salaries all compute overlapping deduction logic, so an agent could plausibly pick the wrong one for a given question (e.g., use compare_salaries when a single take-home is wanted). Descriptions do a good job of resolving this.
Three of four names follow a verb_object pattern (get_uk_tax_bands, calculate_uk_take_home, compare_salaries) and all use snake_case. marginal_rate_at_income breaks the verb pattern as a noun phrase, but it is still readable and semantically accurate.
Four tools is well-scoped for a focused UK salary tax server: reference data, marginal analysis, net pay calculation, and comparison each earn their place. Nothing appears redundant enough to remove, nor is anything obviously missing at this scope.
The surface covers lookups, marginal rates, net pay, and multi-salary comparison with NI, student loans, pensions, and allowance taper — solid coverage for the domain. Minor gaps remain, such as reverse gross-from-net calculation or employer-side NI/cost, which agents would have to work around manually.
Maintenance
Related MCP Connectors
Verified UK take-home pay: income tax, NI, student loans, pensions, with GOV.UK sources.
United Kingdom 2026-27: full income tax return, net salary, gross for net, employer cost
UK tax: take-home pay, self-employed and company tax, VAT, stamp duty, invoices and MTD.
Over 200 free UK-focused calculators, converters and generators as MCP tools: take-home pay and National Insurance for 2026/27, VAT, stamp duty, mortgages, loans, savings, inflation since 1988, currency with live rates, dates and working days with bank holidays, unit conversions, health calculators, colour and text utilities, encoding, hashing, JWT and TOTP, and validators for IBANs and Bitcoin and Ethereum addresses. Every tool is read-only, stateless and computes on the spot; nothing you send is stored. Each result links to its source page on hopi.co.uk.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceCalculate income tax (UK/US brackets), EU VAT, UK corporation tax, and capital gains tax. Provides estimates only - not professional tax advice.3 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to compute US take-home pay, self-employment taxes, and capital gains taxes for the 2026 tax year using the engine from statetakehome.com.353 npmMIT
- AlicenseAqualityBmaintenanceEnables users to calculate 2025–2026 take-home pay, compare net pay across states, convert salary and hourly wages, and retrieve federal tax brackets and deductions, including FICA, Additional Medicare, and pre-tax 401(k)/HSA effects.539 npmMIT
- AlicenseAqualityBmaintenanceEnables looking up sourced Danish income tax rates, thresholds and municipal tax figures for 2025–2027, and estimating salary income tax, take-home pay, marginal rates and skattekort details such as trækprocent and månedsfradrag.547 PyPIMIT