Australian income tax and refund estimate
annual_tax_estimateAustralian income tax for a whole financial year and the likely refund or bill: tax at resident or foreign rates, low income tax offset, seniors and pensioners tax offset, Medicare levy with low-income and family reductions, Medicare levy surcharge and compulsory HELP/study loan repayments, compared with the tax withheld. Applies the $1,000 standard deduction for work-related expenses from 2026-27 and the working Australians tax offset (up to $250) from 2027-28. Use it for tax return estimates and questions involving deductions, other income, overtime, bonuses, couples and families, seniors or private health cover. For per-pay take-home figures use take_home_pay. Supports 2025-26, 2026-27 and 2027-28 (an estimate with no refund). estimatedRefund is positive for a refund and negative for a bill. AUD. Read-only and deterministic.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"salary": "<salary>"
},
"name": "annual_tax_estimate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bonus | No | Bonuses paid in the year (AUD). | |
| sapto | No | Eligible for the seniors and pensioners tax offset, with this status. | |
| family | No | Spouse and dependent children, for the Medicare levy family reduction and surcharge thresholds. | |
| salary | Yes | Salary or wages for the year from one employer (AUD), excluding super, overtime and bonuses. | |
| taxYear | No | Financial year. Default 2026-27. | |
| overtime | No | Overtime earnings for the year (AUD). | |
| studyLoan | No | Has a HELP, VSL, SSL or other study and training support loan. Default false. | |
| deductions | No | Work-related expenses the person would itemise (AUD). From 2026-27 residents with work income get at least the $1,000 standard deduction, so amounts up to $1,000 don't change the result. | |
| otherIncome | No | Other taxable income with no tax withheld, e.g. interest (AUD). | |
| tfnProvided | No | Employee gave their tax file number. Default true. False applies the no-TFN rate. | |
| payFrequency | No | How often the salary is paid, for tax withheld. Default fortnightly. | |
| foreignResident | No | Foreign resident for tax purposes. Default false. | |
| otherDeductions | No | Deductions not covered by the standard deduction, such as gifts to charity and tax agent fees (AUD). | |
| taxFreeThreshold | No | Tax-free threshold claimed with this employer. Default true (main job). Use false for a second job. | |
| salaryIncludesSuper | No | salary is a package including the 12% super guarantee. | |
| privateHospitalCover | No | Has private patient hospital cover all year. Default true (no Medicare levy surcharge). |