home / mcp / scryfall mcp server

Scryfall MCP Server

MCP Server for Scryfall

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bmurdock-scryfall-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/scryfall-mcp/dist/index.js"
      ],
      "env": {
        "NODE_ENV": "development",
        "LOG_LEVEL": "info",
        "RATE_LIMIT_MS": "100",
        "HEALTHCHECK_DEEP": "false",
        "SCRYFALL_TIMEOUT_MS": "15000",
        "SCRYFALL_USER_AGENT": "ScryfallMCPServer/1.0",
        "RATE_LIMIT_QUEUE_MAX": "500"
      }
    }
  }
}

You run a Scryfall MCP Server to access rich Magic: The Gathering card data and tooling from MCP-enabled assistants. It provides fast, validated queries to Scryfall, intelligent caching, and easy integration with your Claude Desktop setup so you can build, search, and analyze cards and sets efficiently.

How to use

You connect your client to the Scryfall MCP Server to perform card searches, retrieve card details and prices, and run analysis and deck-building prompts. Use the available tools to build optimized Scryfall queries from natural language, search with Scryfall syntax, fetch specific cards and sets, get current prices, and generate discovery or competitive analyses. The server handles rate limits, caching, and error scenarios so you can focus on getting accurate results for your AI workflows.

How to install

Prerequisites: Node.js 18 or newer, and npm or yarn.

1. Install dependencies locally.

2. Build the project and prepare to run.

Configuration & integration

Configure your MCP connection to the Scryfall MCP Server as a local stdio server. The runtime runs with Node and executes the main build under dist/index.js.

Claude Desktop integration example shows how to wire the MCP server into Claude Desktop so you can access the Scryfall MCP endpoints directly from your AI workspace.

Configuration details

{
  "mcpServers": {
    "scryfall": {
      "command": "node",
      "args": ["/absolute/path/to/scryfall-mcp/dist/index.js"]
    }
  }
}

Claude Desktop integration

Add the MCP server configuration to Claude Desktop so it can discover and use the Scryfall MCP Server from your machine.

{
  "mcpServers": {
    "scryfall": {
      "command": "node",
      "args": ["/absolute/path/to/scryfall-mcp/dist/index.js"]
    }
  }
}

Tool usage overview

The server exposes a collection of MCP tools you can invoke from your client. These tools handle synthesis, search, and analysis workflows, producing structured results and explanations to help you make informed decisions.

Troubleshooting

If you encounter rate limits, disable gzip if you run into parsing issues, verify the absolute path in your Claude Desktop config, and ensure the server has built successfully before starting Claude.

Available tools

build_scryfall_query

Convert natural language requests into optimized Scryfall search queries, with explanations and alternatives. This tool supports format preferences and optimization strategies to produce precise queries.

search_cards

Search for cards using Scryfall's comprehensive search syntax to return matching results.

get_card

Retrieve detailed information about a specific card by name, identifier, or set/collector number.

get_card_prices

Fetch current price data for cards to assist budgeting and purchasing decisions.

random_card

Return random cards with optional filters to aid discovery and exploration.

search_sets

Search and filter Magic sets to find relevant collections or metadata.

analyze_card

Generate a comprehensive card analysis including competitive viability, synergies, and meta positioning.

build_deck

Create deck-building guides and recommendations centered around specific cards or themes.