search_cards

search_cards

Search for Magic: The Gathering cards using Scryfall syntax to filter by color, type, set, and more. Retrieve results in JSON or text format, with options for pagination, sorting, and price filtering.

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

Input Schema (JSON Schema)

{
  "properties": {
    "arena_only": {
      "default": false,
      "description": "Only return cards available in Arena",
      "type": "boolean"
    },
    "direction": {
      "default": "auto",
      "description": "Sort direction",
      "enum": [
        "asc",
        "desc",
        "auto"
      ],
      "type": "string"
    },
    "format": {
      "default": "text",
      "description": "Response format - text for human-readable, json for structured data",
      "enum": [
        "json",
        "text"
      ],
      "type": "string"
    },
    "include_extras": {
      "default": false,
      "description": "Include tokens, emblems, and other extras in search results",
      "type": "boolean"
    },
    "include_multilingual": {
      "default": false,
      "description": "Include cards in all languages",
      "type": "boolean"
    },
    "include_variations": {
      "default": false,
      "description": "Include rare card variants",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Number of cards to return (1-175)",
      "maximum": 175,
      "minimum": 1,
      "type": "number"
    },
    "order": {
      "description": "Sort order for results",
      "enum": [
        "name",
        "released",
        "cmc",
        "power",
        "toughness",
        "artist",
        "set",
        "rarity",
        "color",
        "usd",
        "eur",
        "tix",
        "edhrec",
        "penny",
        "review"
      ],
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination (starts at 1)",
      "minimum": 1,
      "type": "number"
    },
    "price_range": {
      "description": "Price filtering constraints",
      "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": "Scryfall search query using their syntax (e.g., \"lightning bolt\", \"c:red type:instant\", \"set:dom\")",
      "type": "string"
    },
    "unique": {
      "default": "cards",
      "description": "Strategy for omitting similar cards",
      "enum": [
        "cards",
        "art",
        "prints"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Scryfall MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Scryfall MCP Server

Related Tools

MCP directory API