Skip to main content
Glama
mythic-index-mcp

mythic-index-mcp

by wizkid17

Mythic Index MCP Server

Magic: The Gathering card prices, deck analysis, and investment intelligence — powered by live data from 5 vendors covering 99K+ cards.

Connect this MCP server to Claude Desktop, Claude Code, or any MCP-compatible AI assistant to get real-time MTG card pricing, deck cost analysis, sealed product EV calculations, and investment insights.

What You Can Do

Ask about prices:

"What's the current price of Sheoldred, the Apocalypse?"

Build decks on a budget:

"Find me black creatures with deathtouch under $5 legal in Modern"

Price a full decklist:

"Price this deck: 4 Lightning Bolt, 4 Goblin Guide, 20 Mountain — check Modern legality"

Evaluate sealed products:

"Is the Modern Horizons 3 Collector Booster Box worth buying at $280?"

Track investments:

"What cards spiked this week? Show me Reserved List cards under $50"

Understand strategy:

"What role does Counterspell play? Find me blue counter spells for Commander under $3"

Related MCP server: scryfall-mcp-server

Quick Start

Prerequisites

  • Python 3.10+ (the MCP SDK requires 3.10 or newer)

  • Claude Desktop, Claude Code, or any MCP-compatible client

Install

The published package runs with no manual install via uv:

uvx mythic-index-mcp

Or install from source:

git clone https://github.com/wizkid17/mythic-index-mcp.git
cd mythic-index-mcp
pip install -r requirements.txt

Configure Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mythic-index": {
      "command": "uvx",
      "args": ["mythic-index-mcp"]
    }
  }
}

Restart Claude Desktop. The Mythic Index tools will appear in the tools menu (hammer icon).

Configure Claude Code

claude mcp add mythic-index uvx mythic-index-mcp

Use Your Own API Key (optional)

The server includes a public read-only key with rate limiting. For higher rate limits, get your own key and set it as an environment variable:

{
  "mcpServers": {
    "mythic-index": {
      "command": "uvx",
      "args": ["mythic-index-mcp"],
      "env": {
        "MYTHIC_INDEX_API_KEY": "mi_your_key_here"
      }
    }
  }
}

Available Tools (21)

Search & Discovery

Tool

Description

search_cards

Fuzzy name search — handles typos and partial names

find_cards

Advanced filters: oracle text, color, type, CMC, price, format, Reserved List

browse_cards

Browse by price, name, or newest sets

list_sets

List and search all 971 MTG sets

Pricing

Tool

Description

get_card_price

Current prices across TCGPlayer, Card Kingdom, CardMarket, CardSphere, CardHoarder

get_price_history

Price trends over 7/30/90/365 days

Sets & Sealed Products

Tool

Description

get_set_stats

Rarity distribution, avg price, total value, chase card, top 10

search_sealed

Find booster boxes, packs, bundles, commander decks

get_sealed_ev

Full EV breakdown with tier analysis (bulk → jackpot)

Investment

Tool

Description

top_movers

Biggest price gains and drops over any period

find_arbitrage

Cross-vendor profit opportunities (buy retail, sell buylist)

reserved_list_tracker

Browse Reserved List cards — never reprinted

Deck Analysis

Tool

Description

price_deck

Full decklist pricing: total cost, vendor comparison, mana curve, legality, budget swaps

suggest_budget_alternatives

Find cheaper cards with similar type and CMC

analyze_mana_curve

Curve visualization, land count evaluation, color source requirements

Strategy

Tool

Description

check_legality

Format legality: Standard, Modern, Pioneer, Commander, Legacy, Vintage, Pauper

evaluate_card

Strategic roles, keyword abilities, archetype fit

find_cards_by_role

Search by role: removal, ramp, card draw, burn, counter, tutor, and 7 more

Rules

Tool

Description

search_rules

Full-text search the official Comprehensive Rules + glossary

get_rule

Get a rule by number with its sub-rules (e.g. 509.1)

System

Tool

Description

get_api_status

Platform health and sync status

Data Coverage

Metric

Value

Cards

99,000+

Sets

971

Price sources

TCGPlayer, Card Kingdom, CardMarket, CardSphere, CardHoarder

Price listings

534,000+

Sealed products

3,900+ with EV calculations

Cards with format legality

99,287

Reserved List cards

1,096

Update frequency

Daily at 3 AM Lima (UTC-5)

Using as a Claude Project

For the best experience, create a Claude Project and add the contents of skill/system_prompt.md as the Project Instructions. This gives Claude deep MTG domain knowledge on top of the live data tools.

Self-Hosting

If you run your own Mythic Index API instance:

export MYTHIC_INDEX_API_URL=http://localhost:8000
export MYTHIC_INDEX_API_KEY=your-key
python3 mcp_server.py

For remote SSE hosting:

python3 mcp_server.py --sse --port 8080

API

This MCP server connects to the Mythic Index API. Documentation: api.mythic-index.com/mtg-api/docs

License

MIT — see LICENSE

Available Tools

21 tools
analyze_mana_curveB
Read-only

Analyze mana curve, lands, color sources. Args: decklist: Same format as price_deck.

Inputs: decklist (required). Returns: result

browse_cardsA
Read-only

Browse MTG cards by price, name, or newest. Args: sort: price/name/recent. order: desc/asc. rarity/set_code: filters. limit: 1-50.

Inputs: sort, limit, order, rarity, +1 more. Returns: result

check_legalityD
Read-only

Format legality check. Args: card_id: From search results.

Inputs: card_id (required). Returns: result

evaluate_cardA
Read-only

Strategic analysis: roles, keywords, archetypes. Args: card_id: From search.

Inputs: card_id (required). Returns: result

find_arbitrageB
Read-only

Cross-vendor profit opportunities. Args: min_spread: Min profit USD. limit: 1-50.

Inputs: limit, min_spread. Returns: result

find_cardsA
Read-only

Find MTG cards by ability text, type, color, CMC, price, format. For deck building queries like 'black creatures with deathtouch under $5'. Args: oracle_text: Rules text search. type_line: Card type filter. colors: Comma-separated W,U,B,R,G. color_identity: Exact identity for Commander. cmc_min/cmc_max: Mana value range. rarity: common/uncommon/rare/mythic. keyword: Ability keyword. reserved_list: Only RL cards. price_min/price_max: USD range. format: Legality filter. sort: price/name/recent. limit: 1-50.

Inputs: sort, limit, colors, format, +10 more. Returns: result

find_cards_by_roleA
Read-only

Find cards by role: removal, card_draw, ramp, counter, protection, evasion, token_generation, lifegain, discard, tutor, graveyard, board_wipe, burn. Args: role: Strategic role. colors: W,U,B,R,G. format: modern/commander. max_price: Budget. limit: 1-30.

Inputs: role (required), limit, colors, format, +1 more. Returns: result

get_api_statusA
Read-only

Platform health and sync status.

Inputs: no named parameters. Returns: result

get_card_priceA
Read-only

Current prices across all vendors. Args: card_id: From search results.

Inputs: card_id (required). Returns: result

get_price_historyA
Read-only

Price trends over time. Args: card_id: Card ID. days: 7/30/90/365. finish: nonfoil/foil.

Inputs: card_id (required), days, finish. Returns: result

get_ruleA
Read-only

Get a specific Comprehensive Rule by number, with its sub-rules (e.g. '509.1' returns 509.1, 509.1a, 509.1b...). Args: number: Rule number like '509.1' or '601.2a', or a section like '702'.

Inputs: number (required). Returns: result

get_sealed_evA
Read-only

EV breakdown for sealed product. Args: product_id: From search_sealed.

Inputs: product_id (required). Returns: result

get_set_statsA
Read-only

Set statistics: cards, rarity, prices, top cards. Args: set_code: e.g. 'mh3'.

Inputs: set_code (required). Returns: result

list_setsC
Read-only

List MTG sets. Args: search: Optional name/code filter.

Inputs: search. Returns: result

price_deckA
Read-only

Price a decklist with curve, colors, legality, budget swaps. Args: decklist: '4 Lightning Bolt' per line. format: standard/modern/commander.

Inputs: decklist (required), format. Returns: result

reserved_list_trackerA
Read-only

Reserved List cards — never reprinted. Args: max_price: Budget cap. sort: price/name. limit: 1-50.

Inputs: sort, limit, max_price. Returns: result

search_cardsA
Read-only

Search MTG cards by name with fuzzy matching. Handles typos and partial names. Args: query: Card name (min 2 chars). limit: Max results (1-50).

Inputs: query (required), limit. Returns: result

search_rulesA
Read-only

Search the official Magic Comprehensive Rules + glossary by keyword. Use for rules questions and card interactions (e.g. 'deathtouch trample', 'the legend rule', 'priority'). Args: query: What to look up (min 2 chars). limit: Max rule matches (1-25).

Inputs: query (required), limit. Returns: result

search_sealedB
Read-only

Find sealed products. Args: set_code: Filter by set. category: booster_box/booster_pack/bundle.

Inputs: category, set_code. Returns: result

suggest_budget_alternativesA
Read-only

Cheaper alternatives with similar type/CMC. Args: card_name: Card to replace. max_price: Cap. format: Legality filter.

Inputs: card_name (required), format, max_price. Returns: result

top_moversA
Read-only

Biggest price gains/drops. Args: days: 1-90. direction: up/down. min_price: Filter noise.

Inputs: days, limit, direction, min_price. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 21 tools

    Disambiguation5/5

    All tools have clearly distinct purposes. Search tools differ by query type (fuzzy name, complex filters, browsing, role-based). Analysis tools (mana curve, deck pricing, card evaluation) are distinct. Pricing, legality, rules, sealed, and market tools are also well-separated.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (e.g., analyze_mana_curve, get_card_price). A few deviate (reserved_list_tracker, top_movers) but are still understandable. No mixed conventions like camelCase, so overall consistent.

    Tool Count5/5

    21 tools cover a broad MTG domain: card searching, pricing, deck analysis, rules, sealed products, market data. Each tool serves a clear need without redundancy. The count is well-scoped for a comprehensive index server.

    Completeness5/5

    The tool set covers all major aspects: card discovery (multiple methods), pricing and history, deck building (curve, budget swaps), legality, rules, sealed product EV, and market opportunities. No obvious gaps for the intended functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers