mystic-tutor-mcp

What can it do?

Related MCP server: MTG Card Lookup MCP Server

Quick Start

Claude Code

claude mcp add --transport stdio mystic-tutor -- npx mystic-tutor-mcp

That'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-mcp

Examples

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: 3

Scryfall 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:commander

• otag: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 API

• Transport: 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 analysis

• Response 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