list_receipts
Query signed AI agent receipts to audit activity and track operations. Filter by agent, status, or environment with pagination and sorting by timestamp, cost, or latency for comprehensive reporting and accountability.
Instructions
Query and paginate receipts from local SQLite storage with optional filtering by agent, action, status, environment, type, chain, or tag. Supports sorting by timestamp, cost, or latency. Returns paginated results with total count, page info, and has_next/has_prev flags. Default: 50 receipts per page, sorted by timestamp descending. Use to audit agent activity, generate reports, or find specific receipts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | No | Filter by agent ID (exact match) | |
| action | No | Filter by action name (exact match) | |
| status | No | Filter by status: "pending", "completed", "failed", or "timeout" | |
| environment | No | Filter by environment: "development", "production", "staging", or "test" | |
| receipt_type | No | Filter by type: "action", "verification", "judgment", or "arbitration" | |
| chain_id | No | Filter to receipts in a specific chain | |
| tag | No | Filter to receipts containing this tag | |
| page | No | Page number, starting at 1 (default: 1) | |
| limit | No | Results per page, 1 to 100 (default: 50) | |
| sort | No | Sort field and direction in format "field:asc" or "field:desc" (e.g., "timestamp:desc", "cost_usd:asc") |