Your token balance
research_account_tokensFree. Your balance, the grant that resets each period, purchased tokens that carry over, this period's spend by operation, and your recent charges. Every metered result already carries tokens_charged and tokens_remaining; call this when the user asks how many tokens are left or a call was refused for insufficient tokens.
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": "research_account_tokens"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grant | Yes | Tokens granted every period (resets at the roll, use it or lose it) | |
| recent | No | Your last charges, newest first | |
| balance | Yes | Tokens you can spend right now: this period's grant left + purchased | |
| period_end | No | When the grant resets (null only for an open-ended promo) | |
| period_start | Yes | ||
| grant_remaining | No | This period's grant still unspent; balance = grant_remaining + purchased_remaining | |
| spent_this_period | Yes | ||
| spent_by_operation | No | This period's spend per operation (search, facets, component, component.text...) — the whole period, not just the recent rows | |
| purchased_remaining | Yes | Bought tokens carry across periods until spent |