lookup_tax_rate
MCP /mcp
Pick a single statutory tax-rate slab — either by exact `id` (e.g. `IN-standard-18`, `GB-zero-0`, `CA-hst-13-on`) for a deterministic lookup, or by `country` + free-text `category` (e.g. "office supplies", "restaurant", "exports", "domestic fuel") for a fuzzy best-match. Returns the matched rate, the match score, and the authoritative `source` URL. Use this when a user asks "what slab does X fall into in India?" or "what VAT rate applies to children's car seats?". For broader exploration (all slabs in a country / all rates of one scheme), use list_tax_rates. No customer data — public statutory reference only.
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": "lookup_tax_rate",
"arguments": {}
}
}
Fill arguments using the input schema below.Complete published contract
{
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 3,
"description": "Exact rate id, e.g. ``IN-standard-18`` or ``GB-zero-0``. When set, country/category are ignored."
},
"country": {
"type": "string",
"enum": [
"IN",
"US",
"CA",
"GB",
"AU",
"AE",
"SG",
"NZ"
],
"description": "Country to search within. Required when ``id`` is not provided."
},
"category": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Free-text query — \"office supplies\", \"restaurant\", \"exports\", \"domestic fuel\"."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"call": {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "lookup_tax_rate",
"arguments": {}
}
}
}