`search_cards`

Pack: scryfall · Endpoint: https://gateway.pipeworx.io/scryfall/mcp

Search Magic: The Gathering (MTG) cards using Scryfall’s powerful query syntax (e.g. “c:red type:dragon”, “set:neo rarity:mythic”, “o:flying cmc<=3”). Returns matching MTG cards with names, types, oracle text, sets, rarities, and prices.

Parameters

Name	Type	Required	Description
`query`	string	yes	Scryfall search query, e.g. ‘c:red type:dragon’, ‘set:neo rarity:mythic’. Uses Scryfall’s full-text query syntax.
`order`	string	no	Sort order, e.g. ‘name’, ‘released’, ‘usd’, ‘edhrec’.
`unique`	string	no	Rollup mode (default ‘cards’).

Example call

Arguments

{
  "query": "c:red type:dragon",
  "order": "usd"
}

curl

curl -X POST https://gateway.pipeworx.io/scryfall/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_cards","arguments":{"query":"c:red type:dragon","order":"usd"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_cards', {
  "query": "c:red type:dragon",
  "order": "usd"
});

More examples

{
  "query": "set:neo rarity:mythic",
  "unique": "prints"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "scryfall": {
      "url": "https://gateway.pipeworx.io/scryfall/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_cards