random_card
Retrieve a random Magic: The Gathering card, with options to filter by format, search query, archetype, price range, rarity, or exclude reprints to suit your needs.
Instructions
Get a random Magic: The Gathering card, optionally filtered by format or search criteria
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| archetype | No | Deck archetype preference | |
| exclude_reprints | No | Exclude heavily reprinted cards | |
| format | No | Magic format to filter by legality | |
| price_range | No | Price constraints for random selection | |
| query | No | Optional Scryfall search query to filter random selection (e.g., "c:red", "type:creature") | |
| rarity_preference | No | Preferred rarity level | |
| similar_to | No | Find cards similar to this card |
Input Schema (JSON Schema)
{
"properties": {
"archetype": {
"description": "Deck archetype preference",
"enum": [
"aggro",
"control",
"combo",
"midrange",
"ramp",
"tribal"
],
"type": "string"
},
"exclude_reprints": {
"default": false,
"description": "Exclude heavily reprinted cards",
"type": "boolean"
},
"format": {
"description": "Magic format to filter by legality",
"enum": [
"standard",
"modern",
"legacy",
"vintage",
"commander",
"pioneer"
],
"type": "string"
},
"price_range": {
"description": "Price constraints for random selection",
"properties": {
"currency": {
"default": "usd",
"description": "Currency for price filtering",
"enum": [
"usd",
"eur",
"tix"
],
"type": "string"
},
"max": {
"description": "Maximum price",
"minimum": 0,
"type": "number"
},
"min": {
"description": "Minimum price",
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "Optional Scryfall search query to filter random selection (e.g., \"c:red\", \"type:creature\")",
"type": "string"
},
"rarity_preference": {
"description": "Preferred rarity level",
"enum": [
"common",
"uncommon",
"rare",
"mythic"
],
"type": "string"
},
"similar_to": {
"description": "Find cards similar to this card",
"type": "string"
}
},
"required": [],
"type": "object"
}