Skip to main content
Glama
uk-income-tax-salary-mcp

uk-income-tax-salary-mcp

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/mcp

Tools

Tool

What it does

calculate_uk_take_home

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.

get_uk_tax_bands

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.

compare_salaries

Up to 5 salaries side by side: net pay, effective and marginal rates, and how much of each rise you keep.

marginal_rate_at_income

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/mcp

Claude Code

claude mcp add --transport http uk-income-tax https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp

Or run it locally:

claude mcp add uk-income-tax -- npx -y uk-income-tax-salary-mcp

Claude 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 test

src/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

cups-to-grams-mcp

convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature

https://cups-to-grams-mcp.lipmichal.workers.dev/mcp

dscr-loan-calculator-mcp

calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary

https://dscr-loan-calculator-mcp.lipmichal.workers.dev/mcp

gold-price-per-gram-mcp

get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units

https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp

lake-level-mcp

search_lakes, get_lake_level, get_lake_history, compare_lakes

https://lake-level-mcp.lipmichal.workers.dev/mcp

minimum-wage-mcp

get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage

https://minimum-wage-mcp.lipmichal.workers.dev/mcp

no-tax-on-overtime-mcp

calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility

https://no-tax-on-overtime-mcp.lipmichal.workers.dev/mcp

paycheck-calculator-mcp

calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets

https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp

us-federal-holidays-business-days-mcp

list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

ab-test-sample-size-calculator-mcp

calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk

https://ab-test-sample-size-calculator-mcp.lipmichal.workers.dev/mcp

aca-premium-tax-credit-calculator-mcp

get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap

https://aca-premium-tax-credit-calculator-mcp.lipmichal.workers.dev/mcp

ap-score-distributions-mcp

get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite

https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp

car-loan-interest-deduction-calculator-mcp

calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit

https://car-loan-interest-deduction-calculator-mcp.lipmichal.workers.dev/mcp

estate-gift-tax-exemption-calculator-mcp

get_exemption_amounts, calculate_estate_tax, check_gift, compare_years

https://estate-gift-tax-exemption-calculator-mcp.lipmichal.workers.dev/mcp

recipe-nutrition-calculator-mcp

lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition

https://recipe-nutrition-calculator-mcp.lipmichal.workers.dev/mcp

retirement-contribution-limits-2027-mcp

get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years

https://retirement-contribution-limits-2027-mcp.lipmichal.workers.dev/mcp

section-179-deduction-calculator-mcp

calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment

https://section-179-deduction-calculator-mcp.lipmichal.workers.dev/mcp

student-loan-repayment-assistance-plan-calculator-mcp

calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates

https://student-loan-repayment-assistance-plan-calculator-mcp.lipmichal.workers.dev/mcp

subdomain-finder-mcp

find_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surface

https://subdomain-finder-mcp.lipmichal.workers.dev/mcp

uk-statutory-sick-pay-maternity-pay-calculator-mcp

calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility

https://uk-statutory-sick-pay-maternity-pay-calculator-mcp.lipmichal.workers.dev/mcp

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one

More from zovo

Available Tools

4 tools
calculate_uk_take_homeUK take-home payA
Read-onlyIdempotent
Inspect

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 taxA
Read-onlyIdempotent
Inspect

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 thresholdsA
Read-onlyIdempotent
Inspect

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 salaryA
Read-onlyIdempotent
Inspect

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

    A4.1/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Calculate income tax (UK/US brackets), EU VAT, UK corporation tax, and capital gains tax. Provides estimates only - not professional tax advice.
      3 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      3
      53 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      39 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      47 PyPI
      MIT