Skip to main content
Glama

Scryfall MCP Server

by bmurdock

build_scryfall_query

Transform natural language requests into tailored Scryfall search queries for Magic: The Gathering cards. Optimize results by format, budget, or strategy, with explanations and alternative suggestions.

Instructions

Convert natural language requests into optimized Scryfall search queries with explanations and alternatives

Input Schema

NameRequiredDescriptionDefault
explain_mappingNoWhether to include detailed explanation of natural language to Scryfall mapping
formatNoMagic format to restrict search to (optional)
include_alternativesNoWhether to include alternative query suggestions
max_resultsNoTarget number of results for optimization
natural_queryYesNatural language description of what you want to find (e.g., "red creatures under $5 for aggressive decks", "blue counterspells in modern")
optimize_forNoSearch optimization strategy: precision (fewer, more relevant results), recall (broader search), discovery (interesting cards), budget (cost-effective)precision
price_budgetNoPrice constraints for the search
test_queryNoWhether to test the generated query and optimize based on results

Input Schema (JSON Schema)

{ "properties": { "explain_mapping": { "default": true, "description": "Whether to include detailed explanation of natural language to Scryfall mapping", "type": "boolean" }, "format": { "description": "Magic format to restrict search to (optional)", "enum": [ "standard", "modern", "legacy", "vintage", "commander", "pioneer", "brawl", "pauper", "penny", "historic", "alchemy" ], "type": "string" }, "include_alternatives": { "default": true, "description": "Whether to include alternative query suggestions", "type": "boolean" }, "max_results": { "default": 20, "description": "Target number of results for optimization", "maximum": 175, "minimum": 1, "type": "number" }, "natural_query": { "description": "Natural language description of what you want to find (e.g., \"red creatures under $5 for aggressive decks\", \"blue counterspells in modern\")", "maxLength": 500, "minLength": 1, "type": "string" }, "optimize_for": { "default": "precision", "description": "Search optimization strategy: precision (fewer, more relevant results), recall (broader search), discovery (interesting cards), budget (cost-effective)", "enum": [ "precision", "recall", "discovery", "budget" ], "type": "string" }, "price_budget": { "description": "Price constraints for the search", "properties": { "currency": { "default": "usd", "description": "Currency for price constraints", "enum": [ "usd", "eur", "tix" ], "type": "string" }, "max": { "description": "Maximum price per card", "minimum": 0, "type": "number" } }, "type": "object" }, "test_query": { "default": true, "description": "Whether to test the generated query and optimize based on results", "type": "boolean" } }, "required": [ "natural_query" ], "type": "object" }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bmurdock/scryfall-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server