list_copilot_credits_statement
Page the creator's Copilot Credits statement — every pack, bonus, grant, refund and lapse, and each month's usage per kind, newest first.
Read the lines behind the balance: every pack bought and the bonus it added, every promotion and goodwill grant, every refund and lapse, and each month's usage of each kind, over the last twelve months and newest first. Credits are positive and debits negative, so summing cents follows the balance; a usage line says how many units of which usage_kind the month's cents paid for. The token says whose statement it is, so the tool takes only paging.
Read-only. Never mutates anything.
A statement is always newest first; there is nothing to filter or sort. An agent reconciling a
month reads the pages until has_more is false.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
limitintegeroptionalMaximum lines to return per page (1..100).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "kind": "usage", "kind_label": "Copilot Usage", "cents": -120, "at": "2026-10-01T00:00:00+00:00", "label": "Copilot Turns, October 2026", "expires_at": null, "units": 12, "usage_kind": "operator_turn", "usage_kind_label": "Copilot Turns" }, { "kind": "bonus", "kind_label": "Pack Bonus", "cents": 250, "at": "2026-09-28T14:02:11+00:00", "label": "Regular pack bonus", "expires_at": null, "units": null, "usage_kind": null, "usage_kind_label": null }, { "kind": "purchase", "kind_label": "Pack Bought", "cents": 2500, "at": "2026-09-28T14:02:11+00:00", "label": "Regular pack", "expires_at": null, "units": null, "usage_kind": null, "usage_kind_label": null } ], "meta": { "page": 1, "limit": 25, "total": 3, "has_more": false }}kind is purchase, bonus, welcome, promotion, goodwill, usage, refund or lapsed. expires_at is set on a free grant that lapses. A usage line is dated the first of its month and carries units with usage_kind (operator_turn, inbox_suggestion or member_answer).
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
How is this guide?
Last updated on
get_transaction_fee_summary
Add up one calendar month of the transaction fees Subscriby charged the token's creator — per channel, per kind, per project and per invoice. Read-only.
list_notifications
Read the notification centre of the creator the token acts for — every alert sent to them, newest first, with its class, where it points and whether it was read.