search_cards
Search for Magic: The Gathering cards using Scryfall syntax. Filter by color, type, set, price, and more. Supports pagination, sorting, and options to include tokens or variants. Retrieve results in JSON or text format.
Instructions
Search for Magic: The Gathering cards using Scryfall search syntax. Supports complex queries with operators like color:, type:, set:, etc.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
arena_only | No | Only return cards available in Arena | |
direction | No | Sort direction | auto |
format | No | Response format - text for human-readable, json for structured data | text |
include_extras | No | Include tokens, emblems, and other extras in search results | |
include_multilingual | No | Include cards in all languages | |
include_variations | No | Include rare card variants | |
limit | No | Number of cards to return (1-175) | |
order | No | Sort order for results | |
page | No | Page number for pagination (starts at 1) | |
price_range | No | Price filtering constraints | |
query | Yes | Scryfall search query using their syntax (e.g., "lightning bolt", "c:red type:instant", "set:dom") | |
unique | No | Strategy for omitting similar cards | cards |