free_tier_eligibility
MCP /mcp
Return the HelloBooks Free-plan annual-invoice-turnover thresholds for the 8 priced markets (IN ₹40 lakh / US $100K / GB £90K / AU A$75K / CA C$30K / NZ NZ$60K / SG S$1M / AE AED 375K). Free includes one-time free AI credits with no published number, plus up to 200 transactions per year; per-entity invoice turnover above the country cap forces an upgrade to Pro or Business. Call with no args to get the full table, with `country` for one threshold, or with `country` AND `annualInvoiceRevenue` (in the country currency, NOT USD-equivalent) for a `freeEligible` verdict with headroom math. Bank-feed total and cash receipts are explicitly NOT used for the turnover cap.
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": "free_tier_eligibility",
"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": "ISO country code of the entity. Omit to return the full 8-country threshold table."
},
"annualInvoiceRevenue": {
"type": "number",
"minimum": 0,
"description": "Annual invoice turnover for the entity, in its home currency (NOT USD-equivalent). Only used when `country` is also provided — the tool then returns a `freeEligible` verdict. Bank-feed total and cash receipts are explicitly NOT used by the gate."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"call": {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "free_tier_eligibility",
"arguments": {}
}
}
}