Check a PAYE tax code
check_tax_codeCheck whether a UK PAYE tax code (e.g. 1257L, BR, K475, 1257L W1/M1) looks right for a salary and circumstances, explain what it means, and estimate any over- or under-payment. Flat-rate codes (BR, D0, D1) are only judged when hasMultipleJobs is known; without it the verdict is needs_info. Returns a verdict tier; refund figures are estimates, not amounts owed.
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": {
"taxCode": "<taxCode>",
"grossSalary": "<grossSalary>"
},
"name": "check_tax_code"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taxCode | Yes | The code as printed on a payslip or P45 | |
| taxYear | No | Tax year the code applies to; defaults to the current one | |
| scotland | No | True for a Scottish taxpayer | |
| grossSalary | Yes | Annual gross pay from this job, in pounds | |
| monthsOnCode | No | For emergency codes: how many monthly payslips were paid on it so far | |
| hasCompanyCar | No | ||
| hasMultipleJobs | No | Whether the person has another job or pension; omitted when unknown | |
| hasMarriageAllowance | No | ||
| receivesStatePension | No | ||
| otherBenefitsInKindValue | No | Annual taxable value, in pounds, of any employer benefits in kind other than a company car, as listed in the deductions on an HMRC tax code notice (P2) or a P11D. Omit if none. | |
| marriageAllowanceDirection | No |