next_deadlines
MCP /mcp
Time-aware "what statutory filing is due next?" Returns upcoming filings sorted soonest-first, each with a computed `nextDue` date and `daysUntil`. Optional `country`, `withinDays` (e.g. the next 30/60/90 days), `limit`, and `asOf` (reference date, defaults to today UTC). A concrete date is computed only when it can be placed unambiguously (monthly filings with a due day, or entries with explicit annual dates); quarterly/half-yearly entries given only a day-of-month and per-event filings come back with `scheduleVaries: true` and `nextDue: null`. Dates rotate annually — confirm against each `source` URL.
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": "next_deadlines",
"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": "Restrict to one country (ISO-2). Omit for every country."
},
"withinDays": {
"type": "integer",
"minimum": 1,
"maximum": 730,
"description": "Only return filings whose next due date falls within this many days."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Max rows to return (default 25)."
},
"asOf": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Reference date (YYYY-MM-DD) to compute \"next\" from. Defaults to today (UTC)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"call": {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "next_deadlines",
"arguments": {}
}
}
}