Scryfall MCP Server

What is Scryfall MCP Server?

A comprehensive Model Context Protocol (MCP) server that integrates with the Scryfall API to provide Magic: The Gathering card data and functionality to AI assistants like Claude.

How to use Scryfall MCP Server?

Install Node.js 18+, clone the repository, install dependencies, optionally configure environment variables, and build the project. Then add the server configuration to your Claude Desktop configuration file using the absolute path to the built index.js file. Use MCP tools such as search_cards, get_card, get_card_prices, random_card, and search_sets.

Key features of Scryfall MCP Server

• Full Scryfall search syntax support with boolean logic
• Built-in rate limiting at 100ms minimum intervals
• Intelligent caching reduces API calls by over 70%
• Circuit breaker prevents cascading failures during outages
• Resources for bulk card database and all sets
• Prompts for card analysis and deck building guides

Use cases of Scryfall MCP Server

• Search and filter Magic cards using Scryfall syntax
• Retrieve current prices and set metadata
• Generate random cards with optional filters
• Analyze card competitive viability and synergies
• Create deck building guides around specific cards

FAQ from Scryfall MCP Server

How does rate limiting work?

The server enforces a 100ms minimum interval between requests (10 requests/second max) and automatically retries on 429 responses with exponential backoff.

How do I integrate with Claude Desktop?

Add a JSON block to your Claude Desktop configuration file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json) specifying the command node and the path to the built dist/index.js file.

What happens if a card is not found?

The server returns a 404 error. Verify the card name spelling, use set code + collector number format, or check if the card exists on Scryfall.

Can I clear the cache without restarting?

Yes, you can programmatically clear caches by calling server.clearCaches() or simply restart the server.

What are the system requirements?

Node.js 18+ and npm or yarn. No additional external services or API keys are required beyond the Scryfall API (which is publicly available).