list_tax_rates
MCP /mcp
List statutory tax-rate slabs by jurisdiction — IN GST (5/12/18/28 + zero + exempt + composition trader/manufacturer/restaurant + compensation cess), UK VAT (20 / 5 / zero / exempt), AU GST (10 / GST-free / input-taxed), US sales-tax (state-administered summary, no federal rate), CA GST 5% + HST 13% ON / 15% Atlantic / 14% NS + provincial PST 7% BC / 6% SK / RST 7% MB + QST 9.975% QC, SG GST 9% (+ superseded 8% / zero / exempt), NZ GST 15% (+ zero / exempt), AE VAT 5% (+ zero / exempt). Filter by `country`, `taxType` (GST/VAT/Sales-Tax/HST/PST/QST/IGST/CGST-SGST/TDS/TCS), or `scheme` (standard / reduced / zero / exempt / input-taxed / composition / cess / state-summary). Every entry carries an effective-from date and an authoritative `source` URL (CBIC, gov.uk, ATO, CRA, IRAS, IRD, FTA, Tax Foundation) — agents should confirm the rate against the source before quoting figures to a user. Use this when a user asks "what is the GST rate on X?", "what VAT band does Y fall into?", or "what are the composition slabs in India?". This is the public statutory reference — for an org-specific tax assignment use the authenticated books_classify_event tool.
No account required
Request example
Connect your client to https://agents.hellobooks.ai/mcp, then call:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_tax_rates",
"arguments": {}
}
}
Fill arguments using the input schema below.Complete published contract
{
"inputSchema": {
"type": "object",
"properties": {
"country": {
"type": "string",
"enum": [
"IN",
"US",
"CA",
"GB",
"AU",
"AE",
"SG",
"NZ"
],
"description": "Filter to one jurisdiction. Omit to return every supported country."
},
"taxType": {
"type": "string",
"enum": [
"GST",
"IGST",
"CGST-SGST",
"VAT",
"Sales-Tax",
"HST",
"PST",
"QST",
"TDS",
"TCS"
],
"description": "Filter by statutory tax type (GST, VAT, Sales-Tax, HST, PST, QST, etc.)."
},
"scheme": {
"type": "string",
"enum": [
"standard",
"reduced",
"zero",
"exempt",
"input-taxed",
"composition",
"cess",
"state-summary"
],
"description": "Filter by slab category — standard, reduced, zero, exempt, input-taxed, composition, cess."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"call": {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_tax_rates",
"arguments": {}
}
}
}