Back to Tool Reference
MCP

credits.list_usage

List the org's credit-usage ledger, newest first.

Effectread-onlyScopecredits:readPlanStarter+

The same ledger the dashboard billing page reads — every charge (and refund/adjustment, as negative credits_used) with what triggered it.

Parameters

daysintegerDefault: 30

Look-back window in days. Clamped to [1, 90].

pageintegerDefault: 1

1-indexed.

page_sizeintegerDefault: 50

Clamped to [1, 100].

Returns

resultsobject[]

Each: action, label, credits_used, status, description, tool (MCP tool name when the charge came over MCP, else null), billing_mode, created_at.

totalnumber
Request
json
{
  "name": "credits.list_usage",
  "arguments": {}
}
Response
json
{
  "results": [
    {
      "action": "vto_mockup",
      "label": "VTO Mockup (Virtual try-on)",
      "credits_used": 2,
      "status": "success",
      "description": "Lifestyle vto_front (17aeb002-2322-4bef-88ff-d4fe9e81a2c4)",
      "tool": null,
      "billing_mode": "org_pays",
      "created_at": "2026-09-25T11:36:56.457072+00:00"
    },
    {
      "action": "vto_mockup",
      "label": "VTO Mockup (Virtual try-on)",
      "credits_used": 2,
      "status": "success",
      "description": "",
      "tool": null,
      "billing_mode": "org_pays",
      "created_at": "2026-09-25T11:28:04.444511+00:00"
    }
  ],
  "total": 11,
  "page": 1,
  "page_size": 50
}