list_credit_activity
List your credit ledger entries, newest first — what each tool charged, for which project, plus net spend per tool. Pages with before_id.
Cost: Free (0 credits).
list_credit_activity shows your most recent credit ledger entries, newest first — what was granted, what you bought, and which tool charged what.
What it does
Reads your own credit ledger, scoped to your account, and returns one line per entry: when it happened, the signed number of credits, what kind of entry it is, and the tool behind it.
What counts as an entry
Only entries that moved your balance are listed. A tool run is recorded internally as a charge and a matching settlement marker worth zero credits; the marker is bookkeeping and is left out, because a 0 credits line next to the real charge for the same tool reads as an error rather than as a record.
A run that was refunded therefore shows twice — once as the charge and once as the refund — rather than disappearing. That is what keeps the numbers you see equal to the movements behind your balance.
For the running total itself, use get_credit_balance. For charts and a full history, use the Usage page in your dashboard.
Example
Ask your MCP client in plain language:
What have I spent credits on lately?
Input
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many recent entries to return (1-50, default 10). |
before_id | integer | No | Paging cursor: return only entries older than this entry id. Each answer names the value to pass for the next page. Omit for the newest entries. |
Returns
One line per ledger entry — timestamp, signed credits, kind, and the tool where there is one — newest first, with a pointer to get_credit_balance for your current total. Guidance when nothing has moved your balance yet.