mtg-mcp

mtg-mcp is an unofficial MCP server for Magic: The Gathering deckbuilding. It connects MCP clients to Scryfall card data, local deck workspaces, optional Moxfield imports, Archidekt writeback, Playgroup.gg playgroup data, Commander Spellbook combos, and API-backed deckbuilding evidence.

It is not affiliated with Hasbro, Wizards of the Coast, Magic: The Gathering, Scryfall, Moxfield, Archidekt, Playgroup.gg, or Commander Spellbook.

Install

NuGet .NET Tool

The easiest manual install is the published NuGet tool package:

dotnet tool install --global Nccurry.MtgMcp
mtg-mcp --version
mtg-mcp --smoke

To upgrade an existing install:

dotnet tool update --global Nccurry.MtgMcp

PowerShell note: when invoking the executable by a quoted full path, prefix it with the call operator:

& "C:\Users\you\.dotnet\tools\mtg-mcp.exe" --version

MCP Registry

Registry-aware MCP clients can discover the server by its registry name:

io.github.nccurry/mtg-mcp

The registry entry points to the NuGet package Nccurry.MtgMcp and uses stdio transport. You can also inspect it in the official MCP Registry.

GitHub Release Archive

Release archives are attached to GitHub Releases for the published desktop runtimes:

• win-x64: download mtg-mcp-<version>-win-x64.zip.
• linux-x64: download mtg-mcp-<version>-linux-x64.tar.gz.
• osx-arm64: download mtg-mcp-<version>-osx-arm64.tar.gz.

Extract the archive and configure your MCP client to run the extracted mtg-mcp executable.

From Source

For local development or testing an unreleased branch:

git clone https://github.com/nccurry/mtg-mcp.git
cd mtg-mcp
./bootstrap.sh
task install:local

On Windows:

git clone https://github.com/nccurry/mtg-mcp.git
cd mtg-mcp
.\bootstrap.ps1
task install:local

task install:local packs the current checkout, publishes a self-contained binary for the current machine, and updates the configured local MCP command path when possible.

MCP Client Configuration

Configure your MCP client to run the mtg-mcp stdio command. Scryfall lookup and local deck analysis work without account credentials.

Codex example:

codex mcp add mtg-mcp \
  --env MTGMCP__OPERATION_MODE=plan \
  -- mtg-mcp

JSON MCP client example:

{
  "mcpServers": {
    "mtg-mcp": {
      "command": "mtg-mcp",
      "env": {
        "MTGMCP__OPERATION_MODE": "plan"
      }
    }
  }
}

Set MTGMCP__OPERATION_MODE explicitly:

• read-only: lookup and analysis only.
• plan: lookup, analysis, metadata refresh, local collection writes, and saved edit plans.
• apply: deck edits, checkpoints, and Archidekt writeback. Writeback still requires opening the Archidekt workspace with writeback enabled.

Features

| Area | What the MCP expo

... View full README on GitHub