Get Hmrc Vat Obligations
get_hmrc_vat_obligationsRead the company's VAT obligations (the returns HMRC expects, with their period keys, start/end dates, due dates, and whether they are Open or Fulfilled) directly from HMRC MTD. Use when the user asks "what does HMRC say I owe a return for", "when is my next VAT return due according to HMRC", or to reconcile our periods against HMRC's record. Requires HMRC MTD connected.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_hmrc_vat_obligations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End date (YYYY-MM-DD). Defaults to today. | |
| from | No | Start date (YYYY-MM-DD). Defaults to 12 months ago. A range longer than about a year is capped to the year ending at the end date, so ask in yearly chunks for anything older. | |
| 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. |