Record a purchase
record_purchaseRecords a card the user bought to their SlabLineage collection with the price actually paid, on the Deal Desk session. Before calling, ask the user "Record bought for $?" and pass confirm true after they say yes. Give dealId from check_deal (preferred) or the same card fields as check_deal; for a slab pass certNumber read off the label when visible; quantity is for raw cards. PSA and TAG slabs with a cert SlabLineage can check go in the collection; other slabs are logged in Deal Desk without joining the collection (the pc.message says which). Pass an idempotencyKey so a retry never records twice. When the result has a nextLine (offering to list the card for sale), ask it. Where the assistant shows panels, the result opens a photo panel where the user can take the card's photo for the listing. If the result has alerts, show them to the user before anything else.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pricePaid": "<pricePaid>",
"confirm": "<confirm>"
},
"name": "record_purchase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | No | Default pokemon. | |
| grade | No | The grade on the slab label, e.g. "10" or "9.5". Not needed for RAW. | |
| cardId | No | SlabLineage card id from search_cards (any row of the card). Give cardId or the catalog id; one of them is required. | |
| dealId | No | The dealId from check_deal. | |
| grader | No | Without dealId: the grading company on the label (PSA, TAG, CGC, BGS …) or RAW. | |
| confirm | Yes | True once the user said yes to recording this purchase; never set it before that. | |
| quantity | No | Raw cards: how many (default 1). | |
| pricePaid | Yes | The price the user actually paid in USD (the total for the quantity). | |
| certNumber | No | The cert number on the slab label, when visible. | |
| scrydexCardId | No | Or the card's catalog id, e.g. "sv3pt5-199" (when you have it instead of cardId). | |
| idempotencyKey | No | A unique key for this record (any short text you make up once); a retry with the same key never records twice. |