Search Commander-legal cards
search_cardsSearch Commander-legal paper cards by name, role, or Scryfall syntax. Supports color identity, mana value, card type, price, and commander interaction filters. Returns rules text, commander fit when a commander is supplied, and a legal same-role alternative when available. Prices link to TCGplayer. Supports comparing printings, estimated totals by quantity, and previewing a cart for explicitly selected cards with owned copies deducted.
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": {
"query": "<query>"
},
"name": "search_cards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| limit | No | ||
| query | Yes | ||
| colors | No | ||
| finish | No | Preferred finish. Carry this into follow-up searches. | |
| qaTest | No | Internal QA only: set true when the user explicitly says this is our test run. Excludes the call from usage/revenue statistics. Omit for normal player requests. | |
| cardType | No | ||
| quantity | No | Show the estimated price for this many copies of each card. | |
| exactName | No | ||
| printings | No | Compare up to two priced printings per result. Use for an exact card or a shortlist. | |
| similarTo | No | Exact card name from a previous result when the player asks for similar cards. | |
| maxPriceUsd | No | ||
| compareNames | No | Show two or three exact names side by side from the current search, keeping its existing filters. | |
| groupByPrice | No | Group the shortlist into under $1, $1–$4.99, $5 and up, and price unavailable. | |
| maxManaValue | No | ||
| minManaValue | No | ||
| commanderName | No | Optional exact commander name for conditional, curated interaction explanations. | |
| excludedNames | No | ||
| searchContext | No | Signed context from the previous result’s followUp.toolCall.arguments.searchContext for requests for more matching cards or a related search. Copy it unchanged. Omit for a new, unrelated search. | |
| shoppingSelection | No | Use only for a user-confirmed shopping selection. Repeat the relevant search, pass exact names and quantities, and include owned copies when known. To edit a selection, pass the revised list. | |
| commanderInteractions | No | Restrict the search to the curated interaction candidate for commanderName, intersecting all other search filters. Requires commanderName. Coverage is limited; no result does not mean no synergy. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | Yes | ||
| followUp | No | ||
| warnings | No | ||
| alternative | No | ||
| priceSource | No | ||
| shoppingCart | No | ||
| searchContext | No | ||
| answerMarkdown | Yes | Complete linked-price answer for clients that do not render the native result card. | |
| priceCheckedAt | No | ||
| shoppingContext | No | ||
| affiliateDisclosure | No |