Check Vat Number
check_vat_numberCheck a UK VAT registration number against HMRC's live Check-a-UK-VAT-number register and return the registered trader name and address. GB only. A "not registered" answer is a real answer from HMRC, not an error. Use this when the user asks whether a VAT number is valid, when adding or editing a supplier or customer with a VAT number, and when a VAT number appears on a document and the user wants it confirmed. Report the registered name back to the user, and point out when it does NOT match the contact's name: a mismatch is the actual thing worth flagging.
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": {
"vat_number": "<vat_number>"
},
"name": "check_vat_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company | No | Which company to read, by name or id, when the account has more than one (see list_companies). Leave it out to use the only company, or the default. | |
| contact_id | No | Optional. The contact this VAT number belongs to, so the result can be reported against them. | |
| vat_number | Yes | UK VAT registration number, 9 digits, with or without the GB prefix. |