mystic-tutor-mcp
What can it do?
Tool | Description |
| Look up any card by name (fuzzy matching). Returns mana cost, oracle text, prices, legalities, and more. |
| Full Scryfall search syntax — find cards by type, color, CMC, keywords, set, etc. |
| Official WotC rulings for any card. |
| Smart synergy finder — analyzes a card's mechanics and finds complementary cards using Scryfall's community tags. |
| Find similar cards by function, stats, type, or overall characteristics. |
Quick Start
Claude Code
claude mcp add --transport stdio mystic-tutor -- npx mystic-tutor-mcpThat's it. Restart Claude Code and start asking about cards.
Claude Desktop
Add to your ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mystic-tutor": {
"command": "npx",
"args": ["-y", "mystic-tutor-mcp"]
}
}
}From source
git clone https://github.com/Abbabon/mystic-tutor-mcp.git
cd mystic-tutor-mcp
npm install && npm run build && npm link
claude mcp add --transport stdio mystic-tutor -- npx mystic-tutor-mcpExamples
Card lookup
You: What does Rhystic Study do and how much is it?
## Rhystic Study
Mana Cost: {2}{U} | CMC: 3
Type: Enchantment
Oracle Text: Whenever an opponent casts a spell, you may draw a card
unless that player pays {1}.
Prices: USD $6.50 | Foil $7.99
Legalities: Commander: legal | Legacy: legal | Modern: not_legal
EDHREC Rank: 3Scryfall search
You: Find me cheap green creatures with flash that are legal in modern
The tool runs: search_cards with query t:creature c:green keyword:flash f:modern sorted by price.
Synergies
You: What synergizes with Doubling Season in Sultai colors?
The tool detects token and counter themes, then searches for:
otag:synergy-tokens ci<=BUG f:commanderotag:counters-matter ci<=BUG f:commander
Returns top synergy cards grouped by theme.
Similar cards
You: What cards are similar to Lightning Bolt?
The tool decomposes Lightning Bolt's mechanics (o:"deals" o:"damage", t:instant, mv=1) and finds comparable burn spells.
Rulings
You: What are the rulings on Panharmonicon?
Returns the card's oracle text plus all official WotC rulings with dates.
Price check a product
You: How much are the cards in [this Secret Lair] worth?
Claude fetches the product page, extracts card names, then calls get_card for each to compare total card value against the product price.
How it works
Claude ←→ stdio ←→ Mystic Tutor MCP ←→ Scryfall APITransport: stdio (standard MCP protocol)
Data source: Scryfall API (free, no API key needed)
Rate limiting: 100ms minimum between Scryfall requests (per their guidelines)
Synergy engine: Uses Scryfall's
otag:community synergy tags + oracle text pattern analysisResponse format: Structured text optimized for LLM consumption
Requirements
Node.js 18+
An MCP-compatible client (Claude Code, Claude Desktop, or any MCP client)
Roadmap
Deck parsing and analysis (mana curve, color distribution)
Bundled comprehensive rules (
lookup_rule,search_rules)EDHREC integration for commander recommendations
Price comparison across printings
In-memory caching for repeated lookups
Credits
Card data powered by Scryfall
Built with the Model Context Protocol SDK
Inspired by pato/mtg-mcp and ericraio/mtg-mcp
Header art: Mystic Tutor by Lindsey Look
License
MIT