1. Conduid
  2. AI
  3. Mtg MCP
MCP server · AI

Mtg MCP

by · github.com/wtfregia/mtg-mcp

A Model Context Protocol (MCP) server for Magic: The Gathering Commander format, providing comprehensive card information, rulings, pricing, and deck validation tools.

Unclaimed Custom license last commit 7 months ago golangmcpmcp-servermtgmtg-cards
InstallView source
64Good

Scored 9 days ago · breakdown

About Mtg MCP

Mtg MCP is an MCP server published by wtfregia in the AI category: a Model Context Protocol (MCP) server for Magic: The Gathering Commander format, providing comprehensive card information, rulings, pricing, and deck validation tools.

The repository has 1 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/wtfregia/mtg-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (13)

mtg-archidekt-fetchFetch deck data from Archidekt

Parameters not published.

mtg-cardtypes-getGet detailed card type information

Parameters not published.

mtg-combos-searchSearch for card combos in Commander

Parameters not published.

mtg-commander-bracketsGet Commander bracket information

Parameters not published.

mtg-commander-deckValidate commanders and generate deck data

Parameters not published.

mtg-commander-recommendGet EDHREC recommendations for a commander

Parameters not published.

mtg-context-commanderGet comprehensive Commander/EDH format rules

Parameters not published.

mtg-context-getGet basic MTG game information

Parameters not published.

mtg-export-formatGet deck export format guidelines

Parameters not published.

mtg-moxfield-fetchFetch deck data from Moxfield (with automatic commander detection)

Parameters not published.

Show all 13 tools
mtg-rules-getGet overview of comprehensive rules

Parameters not published.

mtg-rules-searchSearch rules by section or keyword

Parameters not published.

mtg-ruling-searchSearch official card rulings

Parameters not published.

Ask AI

✦

Ask AI about Mtg MCP

Powered by Claude · Grounded in docs

I know everything about Mtg MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.1.2v0.1.2 · 12 Nov 2025What's Changed refactor: Breaking up `main.py` into module. by @wtfregia in https://github.com/wtfregia/mtg-mcp/pull/3 test: Adding unit tests. by @wtfregia in https://github.com/wtfregia/mtg-mcp/pull/7 docs: Revamping documentation. by…
v0.1.1v0.1.1 · 12 Nov 2025What's Changed feat: Adding Archidekt support. by @wtfregia in https://github.com/wtfregia/mtg-mcp/pull/1 Full Changelog: https://github.com/wtfregia/mtg-mcp/compare/v0.1.0...v0.1.1

README

MTG-MCP

Magic: The Gathering Model Context Protocol Server

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with rich Magic: The Gathering information, including card data, comprehensive rules, EDHREC recommendations, combo interactions, and intelligent Commander deck generation.

PyPI version

Quick Links

Overview

MTG-MCP integrates multiple Magic: The Gathering data sources to provide AI assistants with authoritative information for answering questions, making recommendations, and generating legal Commander decklists. The server leverages official comprehensive rules, Scryfall card database, EDHREC statistics, and Commander Spellbook combo data.

Features

Core Information Tools

  • Comprehensive Rules Access: Query the official Magic: The Gathering comprehensive rules by section or keyword
  • Card Information: Retrieve detailed card data including type, mana cost, oracle text, and legality
  • Card Rulings: Access official card rulings and clarifications from Scryfall
  • Card Type Information: Get detailed information about card types, subtypes, and supertypes

Commander-Specific Tools

  • Commander Format Context: Comprehensive information about Commander/EDH format rules, deck construction, and gameplay
  • EDHREC Integration: Pull top recommended cards for any commander based on EDHREC data
  • Combo Search: Find card combinations and interactions from Commander Spellbook
  • Bracket System: Access Commander power level brackets (1-5) with detailed criteria and guidelines
  • Dynamic Game Changers List: Automatically updated list of high-impact cards that affect deck power level
  • Dynamic Banned List: Real-time Commander banned cards list from Scryfall

Deck Generation & Import

  • Commander Deck Validation: Validates commander legality including partner rules (Partner, Partner with, Choose a Background, Friends Forever, Doctor's Companion)
  • [HIGHLY EXPERIMENTAL] Deck Generation: Generates complete 100-card Commander decklists based on:
    • EDHREC recommendations
    • Target power level bracket (1-5)
    • Commander color identity restrictions
    • Deck composition best practices
    • Combo synergies
  • Deck Import: Fetch and analyze decks from popular deck-building platforms:
    • Moxfield: Import decks with automatic commander detection
    • Archidekt: Import decks with category organization
  • Export Format: Generates decklists in standard format compatible with Moxfield, Archidekt, and other deck building tools

Installation

For detailed installation instructions and troubleshooting, see the Setup Guide.

Quick Start (Recommended)

Install directly from PyPI:

pip install mtg-mcp

Or using uv:

uv pip install mtg-mcp

Development Installation

For development or to use the latest unreleased features, see the Development Installation section in the Setup Guide.

Usage

For complete usage instructions and configuration examples, see the Configuration Guide.

Running as a Standalone Server

After installation, you can run the server directly:

mtg-mcp

For debug logging:

mtg-mcp --debug

MCP Client Integration

Configuration examples for popular MCP clients:

See the Configuration Guide for detailed setup instructions and troubleshooting.

Available Tools

For complete API documentation with parameters, return types, and examples, see the Tools Documentation.

The server exposes the following MCP tools:

  • mtg-context-get: Get basic MTG game information
  • mtg-context-commander: Get comprehensive Commander/EDH format rules
  • mtg-cardtypes-get: Get detailed card type information
  • mtg-rules-get: Get overview of comprehensive rules
  • mtg-rules-search: Search rules by section or keyword
  • mtg-ruling-search: Search official card rulings
  • mtg-combos-search: Search for card combos in Commander
  • mtg-commander-recommend: Get EDHREC recommendations for a commander
  • mtg-commander-brackets: Get Commander bracket information
  • mtg-export-format: Get deck export format guidelines
  • mtg-commander-deck: Validate commanders and generate deck data
  • mtg-archidekt-fetch: Fetch deck data from Archidekt
  • mtg-moxfield-fetch: Fetch deck data from Moxfield (with automatic commander detection)

Examples

For more examples and detailed usage patterns, see the Quick Start Guide and Tools Documentation.

Generate a Competitive EDH Deck

Use #mtg-commander-deck to generate a Bracket 5 (cEDH) commander deck with Tymna the Weaver and Kraum, Ludevic's Opus.

Generate a Casual Commander Deck

Use #mtg-commander-deck to create a Bracket 2 casual deck with Atraxa, Praetors' Voice.

Search for Card Rulings

Use #mtg-ruling-search to find rulings for Doubling Season.

Find Commander Recommendations

Use #mtg-commander-recommend to get the top cards for Kinnan, Bonder Prodigy.

Search for Combos

Use #mtg-combos-search to find combos with Thassa's Oracle.

Data Sources

  • Scryfall API: Card data, rulings, and legality information
  • EDHREC: Commander recommendations and deck statistics
  • Commander Spellbook: Combo interactions and synergies
  • MTG SDK: Card types and subtypes
  • Wizards of the Coast: Official comprehensive rules and banned list
  • Archidekt: Deck import
  • Moxfield: Deck import

Development

Running Tests

pytest

Code Quality

The project uses Ruff for linting and formatting:

ruff check .
ruff format .

Bracket System

MTG-MCP includes support for the Commander bracket system (1-5). For detailed bracket criteria and guidelines, see the Tools Documentation - Commander Brackets.

  • Bracket 1: Casual/Exhibition - Budget-friendly, thematic gameplay
  • Bracket 2: Core - Focused strategies with some powerful cards
  • Bracket 3: Upgraded - Optimized decks with powerful cards and combos
  • Bracket 4: Optimized - Highly tuned with extensive tutors and fast mana
  • Bracket 5: Competitive EDH (cEDH) - Maximum optimization

The deck generator respects bracket specifications when selecting cards and building strategies.

Export Format

For complete export format specifications and examples, see the Tools Documentation - Export Format.

Generated decklists follow the standard format compatible with popular deck building tools like Moxfield and Archidekt.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT License - See LICENSE file for details.

Acknowledgments

  • Scryfall for comprehensive card data API
  • EDHREC for commander recommendations and statistics
  • Commander Spellbook for combo database
  • Wizards of the Coast for Magic: The Gathering

Disclaimer

MTG-MCP is unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards of the Coast. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC.

README fetched from the repository 2 days ago. The original is authoritative.

Questions

About Mtg MCP

How do I install Mtg MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Mtg MCP safe to use with an AI agent?

Its trust score is 64 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Mtg MCP still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.