CheckMyTax NZ: New Zealand Tax Calculators

io.github.brettham70Published by GitHub account brettham70v0.1.0Updated Nov 17, 2026

Cited, dated NZ tax calculators: PAYE take-home, tax codes, IETC, GST, holiday pay. Also AU.

The publisher's own server: check.tattoo: tattoo size and placement guide

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinance

Overview

AI-generated overview

Remote MCP server with cited, dated Australian and New Zealand tax calculators: take-home pay, tax codes, GST, KiwiSaver, super, holiday pay and business days.

What you can do
  • Calculate NZ take-home pay, tax codes, IETC, KiwiSaver, ACC levy, GST and holiday pay
  • Calculate AU take-home pay, HELP repayments, Medicare levy surcharge, novated lease savings, super and GST
  • List public holidays and add, subtract or count business days for AU states and NZ
  • Look up the tax rules used, with ATO/IRD/Employment NZ sources and last-checked dates
  • Return workings, rules year and stated coverage limits with each result
When to use it
Useful when an assistant needs reliable, sourced NZ or AU payroll and tax figures instead of recalling rates from memory, for example estimating take-home pay, picking a tax code, checking GST or counting business days around public holidays.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared.
Before you install
Results are general information, not tax advice, and each tool states what it does not cover (for example share-based pay, carry-forward super caps, regional holiday variations or proposed EV changes). Verify figures against official sources before relying on them for filings or payroll.

Installation

In SourceWeft

  1. Open CheckMyTax NZ: New Zealand Tax Calculators in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.brettham70%2Fcheckmytax/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "checkmytax-nz-new-zealand-tax-calculator": {
      "type": "http",
      "url": "https://mcp.checkmytax.co.nz/mcp"
    }
  }
}

Tools

17

au_mls

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.

ParametersyourequiredyearspousedaysWithoutCoverdependentChildren

au_novated_lease

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.

ParameterssalaryrequiredvehiclerequiredbaseValuerequiredannualCostsrequiredhasHelpDebt

au_take_home

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%.

ParametersannualGrossrequiredhasHelpDebt

au_help_repayment

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.

ParametersrepaymentIncomerequired

au_gst

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).

Parametersmoderequiredamountrequired

au_super

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.

ParameterssalaryrequiredsalarySacrificepersonalDeductible

au_public_holidays

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.

ParametersenddatedaysmoderequiredyearstartregionrequiredextraHolidaysincludeRegionalincludeMondayised

nz_kiwisaver

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.

ParameterssalaryrequiredemployeeRaterequiredemployerRateeligibleForGovernmentContribution

nz_acc_levy

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.

Parametersearningsrequired

nz_public_holidays

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.

ParametersenddatedaysmoderequiredyearstartregionextraHolidaysincludeRegionalincludeMondayised

nz_take_home

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.

ParametersyearclaimIetcannualGrossrequiredkiwisaverRatehasStudentLoan

nz_tax_code

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.

ParametersyearspecialJobisMainIncomerequirednzTaxResidenthasStudentLoantotalAnnualIncomerequiredmainJobAnnualIncomereceivesSuperOrBenefitreceivesWorkingForFamilies

nz_ietc

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.

ParametersyearincomerequiredexcludednzTaxResident

nz_gst

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).

Parametersmoderequiredyearamountrequired

nz_holiday_pay

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).

ParameterstyperequiredgrossworkedweeksTakenalreadyPaidweeksEmployedrelevantDailyPayordinaryWeeklyPayentitledWeeksOwinggrossEarnings12MonthsgrossSinceAnniversary

list_rules

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).

Parameterstopicjurisdiction

get_rule

Get one rule by id (from list_rules), with its source and last-checked date.

Parametersidrequired

Version history

1
  1. v0.1.0LatestNov 17, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Check integrations