CheckMyTax NZ: New Zealand Tax Calculators
Cited, dated NZ tax calculators: PAYE take-home, tax codes, IETC, GST, holiday pay. Also AU.
Should I use this
Quality & Safety
Findings (5)
- HIGHin au_help_repayment
- HIGH
- LOWin au_help_repayment
- LOWin au_super
- LOWin nz_ietc
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": {
"checkmytax": {
"url": "https://mcp.checkmytax.co.nz/mcp"
}
}
}Remote endpoints
https://mcp.checkmytax.co.nz/mcpstreamable-httpWhat it can do
Tool inventory
Tools (17)
⚪au_mls(year, you, spouse, dependentChildren, daysWithoutCover)
Medicare levy surcharge (Australia) [AU]. Works out whether an Australian resident pays the Medicare levy surcharge (MLS) for an income year, which tier applies, how much they'd pay, and the yearly hospital-cover premium below which cover is cheaper than the surcharge. Use it for 'do I need private health insurance to avoid the MLS?' questions. Doesn't handle the low-income spouse exemption, part-year couples or dependants, or super lump sums.
Input Schema
{
"type": "object",
"properties": {
"year": {
"description": "Income year, e.g. \"2026-27\". Supported: 2025-26, 2026-27.",
"type": "string"
},
"you": {
"type": "object",
"properties": {
"taxableIncome": {
"type": "number",
"minimum": 0,
"description": "Taxable income for the year"
},
"reportableFringeBenefits": {
"description": "Reportable fringe benefits",
"type": "number",
"minimum": 0
},
"reportableSuperContributions": {
"description": "Reportable super contributions (e.g. salary sacrifice)",
"type": "number",
"minimum": 0
},
"netInvestmentLosses": {
"description": "Total net investment losses, as a positive amount",
"type": "number",
"minimum": 0
}
},
"required": [
"taxableIncome"
],
"additionalProperties": false
},
"spouse": {
"description": "Leave out if single",
"type": "object",
"properties": {
"taxableIncome": {
"type": "number",
"minimum": 0,
"description": "Taxable income for the year"
},
"reportableFringeBenefits": {
"description": "Reportable fringe benefits",
"type": "number",
"minimum": 0
},
"reportableSuperContributions": {
"description": "Reportable super contributions (e.g. salary sacrifice)",
"type": "number",
"minimum": 0
},
"netInvestmentLosses": {
"description": "Total net investment losses, as a positive amount",
"type": "number",
"minimum": 0
}
},
"required": [
"taxableIncome"
],
"additionalProperties": false
},
"dependentChildren": {
"description": "MLS dependent children",
"type": "integer",
"minimum": 0,
"maximum": 50
},
"daysWithoutCover": {
"description": "Days this year without appropriate private hospital cover (default: whole year)",
"type": "integer",
"minimum": 0,
"maximum": 366
}
},
"required": [
"you"
],
"additionalProperties": false
}⚪au_novated_lease(salary, annualCosts, baseValue, vehicle, hasHelpDebt)
Novated lease savings (Australia) [AU]. Estimates the yearly saving from a novated lease for 2026-27: GST credits, the pre-tax deduction, tax saved and the employee contribution method (20% statutory formula), including the electric car FBT exemption. Doesn't apply the proposed EV changes from 1 April 2027, the operating cost method, balloon payments, fees or super effects.
Input Schema
{
"type": "object",
"properties": {
"salary": {
"type": "number",
"minimum": 0,
"description": "Gross annual salary before the lease"
},
"annualCosts": {
"type": "number",
"minimum": 0,
"description": "Total yearly lease and running costs (finance, fuel or charging, insurance, rego, servicing, tyres), GST-inclusive"
},
"baseValue": {
"type": "number",
"minimum": 0,
"description": "Car base value: GST-inclusive cost price plus delivery and accessories, excluding registration and stamp duty"
},
"vehicle": {
"type": "string",
"enum": [
"electric",
"petrol_diesel_or_hybrid"
],
"description": "electric = battery electric or hydrogen; plug-in hybrids no longer qualify for the exemption"
},
"hasHelpDebt": {
"type": "boolean"
}
},
"required": [
"salary",
"annualCosts",
"baseValue",
"vehicle"
],
"additionalProperties": false
}⚪au_take_home(annualGross, hasHelpDebt)
Take-home pay (Australia) [AU]. Annual income tax, low income tax offset, 2% Medicare levy, optional HELP repayment and take-home pay for an Australian resident in 2026-27, plus employer super at 12%.
Input Schema
{
"type": "object",
"properties": {
"annualGross": {
"type": "number",
"minimum": 0,
"description": "Gross annual salary in AUD, excluding super"
},
"hasHelpDebt": {
"description": "Whether the person has a HELP/HECS debt",
"type": "boolean"
}
},
"required": [
"annualGross"
],
"additionalProperties": false
}⚪au_help_repayment(repaymentIncome)
HELP / HECS compulsory repayment (Australia) [AU]. Compulsory HELP repayment for 2026-27 under the marginal system: nil to $69,528, 15c above, then 17c, then 10% of repayment income above $186,050.
Input Schema
{
"type": "object",
"properties": {
"repaymentIncome": {
"type": "number",
"minimum": 0,
"description": "HELP repayment income in AUD: taxable income plus reportable fringe benefits, net investment losses and reportable super"
}
},
"required": [
"repaymentIncome"
],
"additionalProperties": false
}⚪au_gst(amount, mode)
GST (Australia) [AU]. Adds 10% Australian GST to a GST-exclusive amount, or works out the GST inside a GST-inclusive amount (1/11 of it).
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"mode": {
"type": "string",
"enum": [
"add",
"remove"
],
"description": "add: amount is GST-exclusive; remove: amount is GST-inclusive"
}
},
"required": [
"amount",
"mode"
],
"additionalProperties": false
}⚪au_super(salary, salarySacrifice, personalDeductible)
Super contributions (Australia) [AU]. Works out employer super guarantee (12%), total concessional contributions against the 2026-27 cap of $32,500, how much room is left or how much is excess, 15% contributions tax and net into the fund. Flags when Division 293 may apply. Doesn't cover carry-forward amounts, non-concessional contributions or Division 293 tax amounts.
Input Schema
{
"type": "object",
"properties": {
"salary": {
"type": "number",
"minimum": 0,
"description": "Annual salary (ordinary time earnings) in AUD, before salary sacrifice"
},
"salarySacrifice": {
"description": "Salary sacrificed into super per year",
"type": "number",
"minimum": 0
},
"personalDeductible": {
"description": "Personal contributions you will claim a deduction for",
"type": "number",
"minimum": 0
}
},
"required": [
"salary"
],
"additionalProperties": false
}🟢au_public_holidays(mode, region, year, date, days, ...)
Public holidays and business days (Australia) [AU]. Lists Australian public holidays by state or territory for 2026 and 2027, checks whether a date is a business day, adds or subtracts business days, and counts business days between two dates (Monday to Friday, excluding public holidays). Regional and show-day holidays are excluded unless includeRegional is true, and partial-day holidays (Christmas Eve, New Year's Eve) are not treated as full days. Only 2026 and 2027 are supported; other years return an error.
Input Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"list",
"is_business_day",
"add_business_days",
"business_days_between"
],
"description": "list: public holidays in a year; is_business_day: is a date a working day; add_business_days: move a date forward or back by business days; business_days_between: count business days after start up to and including end"
},
"region": {
"type": "string",
"enum": [
"ACT",
"NSW",
"NT",
"QLD",
"SA",
"TAS",
"VIC",
"WA"
],
"description": "State or territory (required)"
},
"year": {
"description": "list: calendar year",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"date": {
"description": "is_business_day, add_business_days: the date",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"days": {
"description": "add_business_days: whole business days to add (negative to go back)",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"start": {
"description": "business_days_between: start date (not counted)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"description": "business_days_between: end date (counted)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"includeMondayised": {
"description": "NZ: count Mondayised holidays; default true",
"type": "boolean"
},
"includeRegional": {
"description": "AU: count regional holidays such as show days; default false",
"type": "boolean"
},
"extraHolidays": {
"description": "Extra non-working dates, e.g. a shutdown",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"required": [
"mode",
"region"
],
"additionalProperties": false
}⚪nz_kiwisaver(salary, employeeRate, employerRate, eligibleForGovernmentContribution)
KiwiSaver contributions (New Zealand) [NZ]. Works out yearly KiwiSaver contributions for 2026-27: the employee contribution, the employer contribution after employer superannuation contribution tax (ESCT), and the government contribution (25c per $1 up to $260.72 for members earning $180,000 or less). Assumes a full year of eligibility; part-year proration, temporary rate reductions and fund returns aren't covered.
Input Schema
{
"type": "object",
"properties": {
"salary": {
"type": "number",
"minimum": 0,
"description": "Gross annual salary in NZD"
},
"employeeRate": {
"anyOf": [
{
"type": "string",
"enum": [
"0.035",
"0.04",
"0.06",
"0.08",
"0.1"
]
},
{
"type": "number"
}
],
"description": "Employee contribution rate as a decimal: 0.035, 0.04, 0.06, 0.08 or 0.1"
},
"employerRate": {
"description": "Employer rate as a decimal; defaults to the 3.5% minimum",
"type": "number",
"minimum": 0,
"maximum": 0.2
},
"eligibleForGovernmentContribution": {
"description": "False if not eligible (e.g. living overseas); default true",
"type": "boolean"
}
},
"required": [
"salary",
"employeeRate"
],
"additionalProperties": false
}⚪nz_acc_levy(earnings)
ACC earners' levy (New Zealand) [NZ]. ACC earners' levy for 2026-27: 1.75% of earnings up to the maximum liable earnings of $156,641 (GST inclusive). For employees it is deducted through PAYE. Doesn't cover work levies, the self-employed minimum earnings, or part-year earnings.
Input Schema
{
"type": "object",
"properties": {
"earnings": {
"type": "number",
"minimum": 0,
"description": "Annual liable earnings in NZD (salary or self-employed income)"
}
},
"required": [
"earnings"
],
"additionalProperties": false
}🟢nz_public_holidays(mode, region, year, date, days, ...)
Public holidays and business days (New Zealand) [NZ]. Lists New Zealand public holidays and regional anniversary days for 2026 and 2027, checks whether a date is a business day, adds or subtracts business days, and counts business days between two dates (Monday to Friday, excluding public holidays). Mondayised holidays count by default; pass includeMondayised false for people who work weekends. Only 2026 and 2027 are supported; other years return an error.
Input Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"list",
"is_business_day",
"add_business_days",
"business_days_between"
],
"description": "list: public holidays in a year; is_business_day: is a date a working day; add_business_days: move a date forward or back by business days; business_days_between: count business days after start up to and including end"
},
"region": {
"description": "Optional NZ anniversary region to include its anniversary day",
"type": "string",
"enum": [
"Auckland",
"Taranaki",
"Hawke's Bay",
"Wellington",
"Marlborough",
"Nelson",
"Canterbury",
"Canterbury (South)",
"Westland",
"Otago",
"Southland",
"Chatham Islands"
]
},
"year": {
"description": "list: calendar year",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"date": {
"description": "is_business_day, add_business_days: the date",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"days": {
"description": "add_business_days: whole business days to add (negative to go back)",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"start": {
"description": "business_days_between: start date (not counted)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"description": "business_days_between: end date (counted)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"includeMondayised": {
"description": "NZ: count Mondayised holidays; default true",
"type": "boolean"
},
"includeRegional": {
"description": "AU: count regional holidays such as show days; default false",
"type": "boolean"
},
"extraHolidays": {
"description": "Extra non-working dates, e.g. a shutdown",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"required": [
"mode"
],
"additionalProperties": false
}⚪nz_take_home(year, annualGross, kiwisaverRate, hasStudentLoan, claimIetc)
Take-home pay (New Zealand) [NZ]. Works out yearly take-home pay for one main NZ job: income tax, ACC earners' levy, KiwiSaver, student loan and the independent earner tax credit, plus effective and marginal rates and the likely tax code. Divide by 52, 26 or 12 for per-pay figures. Doesn't handle secondary jobs, tailored tax codes, non-residents or the temporary 3% KiwiSaver rate.
Input Schema
{
"type": "object",
"properties": {
"year": {
"description": "NZ tax year, e.g. \"2026-27\". Supported: 2026-27.",
"type": "string"
},
"annualGross": {
"type": "number",
"minimum": 0,
"description": "Gross annual salary or wages before tax, from one main job"
},
"kiwisaverRate": {
"description": "Employee KiwiSaver rate as a decimal, e.g. 0.035; 0 if not in KiwiSaver",
"type": "number"
},
"hasStudentLoan": {
"type": "boolean"
},
"claimIetc": {
"description": "Claim the independent earner tax credit through the ME code, if eligible",
"type": "boolean"
}
},
"required": [
"annualGross"
],
"additionalProperties": false
}🟡nz_tax_code(year, isMainIncome, totalAnnualIncome, mainJobAnnualIncome, receivesWorkingForFamilies, ...)
Tax code (New Zealand) [NZ]. Picks the NZ tax code to put on an IR330 for a job (M, ME, SB, S, SH, ST, SA, CAE, EDW, NSW, with SL for a student loan), following IRD's rules for the common cases, and explains why. Doesn't calculate tailored tax codes or contractor (schedular) rates.
Input Schema
{
"type": "object",
"properties": {
"year": {
"description": "NZ tax year, e.g. \"2026-27\". Supported: 2026-27.",
"type": "string"
},
"isMainIncome": {
"type": "boolean",
"description": "Is this job your main or highest-paying income?"
},
"totalAnnualIncome": {
"type": "number",
"minimum": 0,
"description": "Estimated total yearly income from all sources, before tax"
},
"mainJobAnnualIncome": {
"description": "With several jobs: what the main job alone pays per year",
"type": "number",
"minimum": 0
},
"receivesWorkingForFamilies": {
"type": "boolean"
},
"receivesSuperOrBenefit": {
"description": "NZ Super, a veteran's pension, a main benefit or an overseas equivalent",
"type": "boolean"
},
"nzTaxResident": {
"type": "boolean"
},
"hasStudentLoan": {
"type": "boolean"
},
"specialJob": {
"type": "string",
"enum": [
"casual-agricultural",
"election-day",
"recognised-seasonal-worker"
]
}
},
"required": [
"isMainIncome",
"totalAnnualIncome"
],
"additionalProperties": false
}⚪nz_ietc(year, income, excluded, nzTaxResident)
Independent earner tax credit (New Zealand) [NZ]. Works out the yearly NZ independent earner tax credit (IETC): the full amount between the lower and upper income limits, reducing above that, and nothing for people excluded by Working for Families, NZ Super or a benefit.
Input Schema
{
"type": "object",
"properties": {
"year": {
"description": "NZ tax year, e.g. \"2026-27\". Supported: 2026-27.",
"type": "string"
},
"income": {
"type": "number",
"minimum": 0,
"description": "Yearly income before tax"
},
"excluded": {
"description": "You or your partner get Working for Families, or you get NZ Super, a benefit or a similar pension",
"type": "boolean"
},
"nzTaxResident": {
"type": "boolean"
}
},
"required": [
"income"
],
"additionalProperties": false
}⚪nz_gst(year, amount, mode)
GST (New Zealand) [NZ]. Adds 15% NZ GST to a GST-exclusive amount, or works out the GST inside a GST-inclusive amount (3/23 of it).
Input Schema
{
"type": "object",
"properties": {
"year": {
"description": "NZ tax year, e.g. \"2026-27\". Supported: 2026-27.",
"type": "string"
},
"amount": {
"type": "number",
"minimum": 0
},
"mode": {
"type": "string",
"enum": [
"add",
"remove"
],
"description": "add = amount excludes GST; remove = amount includes GST"
}
},
"required": [
"amount",
"mode"
],
"additionalProperties": false
}⚪nz_holiday_pay(type, ordinaryWeeklyPay, grossEarnings12Months, weeksEmployed, weeksTaken, ...)
Holiday pay (New Zealand) [NZ]. Works out New Zealand holiday pay under the Holidays Act 2003: annual holidays (greater of ordinary weekly pay and average weekly earnings), 8% pay-as-you-go, public holiday pay (time and a half plus an alternative holiday if worked) and holiday pay on finishing a job. Doesn't handle sick or bereavement leave, variable-pay weeks, employer-specific agreements or the Employment Leave Act (due August 2028).
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"annual",
"payg",
"public_holiday",
"final_pay"
],
"description": "annual: pay for annual holidays taken; payg: 8% pay-as-you-go; public_holiday: pay for a public holiday; final_pay: holiday pay on finishing a job"
},
"ordinaryWeeklyPay": {
"description": "annual, final_pay: gross pay for a normal week, excluding bonuses and employer super",
"type": "number",
"minimum": 0
},
"grossEarnings12Months": {
"description": "annual, final_pay: gross earnings in the 12 months before the end of the last pay period",
"type": "number",
"minimum": 0
},
"weeksEmployed": {
"description": "annual, final_pay: weeks employed if under 52; defaults to 52",
"type": "number",
"minimum": 1,
"maximum": 52
},
"weeksTaken": {
"description": "annual: weeks of annual holidays taken; defaults to 4",
"type": "number",
"minimum": 0,
"maximum": 52
},
"gross": {
"description": "payg: gross pay for the period",
"type": "number",
"minimum": 0
},
"relevantDailyPay": {
"description": "public_holiday: what the employee would have earned for the day, including regular allowances",
"type": "number",
"minimum": 0
},
"worked": {
"description": "public_holiday: whether they worked the public holiday",
"type": "boolean"
},
"entitledWeeksOwing": {
"description": "final_pay: weeks of annual holidays entitled to but not taken",
"type": "number",
"minimum": 0
},
"grossSinceAnniversary": {
"description": "final_pay: gross earnings since the last annual holidays anniversary date",
"type": "number",
"minimum": 0
},
"alreadyPaid": {
"description": "final_pay: holiday pay already paid in advance or as pay-as-you-go",
"type": "number",
"minimum": 0
}
},
"required": [
"type"
],
"additionalProperties": false
}🟢list_rules(jurisdiction, topic)
List the tax rules the calculators use (ids, values, ATO/IRD/Employment NZ source URLs and the date each was last checked). Optionally filter by jurisdiction (AU or NZ) or topic (tax, mls, fbt, holidays).
Input Schema
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"enum": [
"AU",
"NZ"
]
},
"topic": {
"type": "string"
}
},
"additionalProperties": false
}🟢get_rule(id)
Get one rule by id (from list_rules), with its source and last-checked date.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}Community
Evidence