Get balance and hunting stats
get_balanceCredit balance, free reviews left, the full hunting record (reviews run, bugs confirmed incl. free minors, false positives, total billed), what everything costs, the last movements of the balance, and a link to Stripe's billing page with the invoices. Call it when the user asks about price, about a charge, or for their payment history – the prices come from the server, so never quote one from memory. For the ACCRUAL HISTORY – what the money bought, what the stories earned, what each hunt cost – pass history (rows per page, newest first) and page with before from the answer's next_cursor. Each row says its kind and hunts – how many hunts a row that is a review, a grant or a code was worth; a movement of money (a top-up of any amount, a refund, a correction) has hunts: null and is read by its delta_usd; catches_left answers a different question and floors, because part of a hunt buys nothing – because the user counts hunts while the ledger counts dollars – the rows that moved no money still moved value, and dollars alone cannot show them. A kind names what happened (purchase / charge / free_review_used / subscription_charge – a review the retired subscription covered, at no charge – / story_grant / promo_grant – a code handing over hunts free hunts – / rating_grant – earned by rating a landing – / species_grant – earned by a species catch, when the server rules and caps allow it – / refund / expiry); credit and debit mean money moved with no more specific reason – an operator correction, money returned – and are also what a movement older than this feature falls back to, so never read a sign label as a date. The one row the history cannot explain is an older one that moved NO money: it reads other, 0 hunts.
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": "get_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| before | No | Paging cursor: the `next_cursor` of the previous page. Only meaningful with `history`. | |
| history | No | Return the accrual history: this many rows, newest first. Omit for the balance alone. |