random_card

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
`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"
}

Scryfall MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Scryfall MCP Server

Related Tools

MCP directory API