What an assistant can and can’t do
- It can browse packs and odds, create orders, follow them until the item is delivered, check what a wallet holds, get sell-back quotes, estimate and create shipments, manage your webhook, read your revenue statement, and drive the sandbox.
- It can’t move money or tokens. Your customer pays for each order and shipment, and the person holding a token signs the transaction that sells it back or ships it. Nothing is ever charged to your key.
- It can’t rotate or revoke keys. Do that through the API, so an assistant can never lock itself out.
Connect
- URL:
https://catchbackcards.com/api/mcp - Auth: your key, as
Authorization: Bearer cb_live_.... It needs thenft:ordersscope. A key without it sees onlywhoami, which tells you what’s missing and what to do next. - Transport: Streamable HTTP, stateless, JSON responses.
- Claude Code
- JSON config
Try it
Once connected, ask your assistant to:- “Run
whoami.” This confirms the key and shows your program. - “List the Pokémon packs, then show me the odds for the Bronze pack.”
- “Create a Bronze pack order for wallet
0x….” - In the sandbox: “Pay that order, tick until it’s minted, and tell me what was pulled.”
- “Get a sell-back quote for that token.”
Tools
The
sandbox_ tools return 404 outside the sandbox.
Arguments
order_id:create_order,create_shipmentandcreate_token_shipmenttake anorder_id, which is sent as theIdempotency-Key. Have the assistant make a new one for each order and reuse it when retrying that order: a retry with the sameorder_idreturns the same order, while a neworder_idcreates a second one.get_orderandget_order_verificationalso takeorder_id, your id or ours.- Ids in the path:
token_id(token, quote and one-token shipment tools),quote_id(get_quote),shipment_id(get_shipment,renew_shipment,sandbox_ship),wallet(list_wallet_tokens),webhook_id(delete_webhook,test_webhook) andintent_id(sandbox_pay). - Everything else is the endpoint’s query parameter or body field of the same name.
- Errors come back as a tool result with
isError: true, the HTTP status and the error body, including itscode, so the assistant can read it and react.

