mtg-export

A CLI that turns a Magic: The Gathering deck into a printable PDF proxy sheet — a 3×3 grid of card images at true card size (2.5″×3.5″) on US-Letter pages, with faint cut guides. Point it at an Archidekt deck, a text card list, or your clipboard.

Card images come from Scryfall, respecting their usage policy (descriptive User-Agent, request throttling, and on-disk image caching so files are never re-downloaded).

A page from a generated proxy sheet — 3×3 cards at true size with cut guides.

Install

npm install          # pdf-lib + @modelcontextprotocol/sdk

Requires Node 18+ (developed on Node 24). No Python, no native modules.

Optionally link it as a global command:

npm link             # then run `mtg-export ...` anywhere

Related MCP server: MCP MD2PDF Server

Usage

# Archidekt deck by id or URL (public/unlisted work with no login)
node index.js 2087352
node index.js https://archidekt.com/decks/2087352/the-public-library

# From a text export file
node index.js --file mydeck.txt

# From the clipboard (macOS pbpaste) — e.g. after "Copy" on Archidekt/Moxfield
node index.js --clipboard

Options

Text list format

One card per line, in the common Archidekt/Moxfield/MTGA export shape. The set code and collector number are honored when present, so you get the exact printing:

1x Sol Ring (mh1) 213
1 Delver of Secrets (isd) 51        # double-faced: both faces are printed
2 Lightning Bolt (2x2) 117 *F*      # *F* (foil) is accepted and ignored for art
3 Forest                            # basic land — excluded unless --include-basics
Counterspell                        # bare name resolves to a default printing

# ... / // comment lines and section labels (Deck, Sideboard, Commander, …) are ignored. If a collector number doesn't match the named card, it falls back to a name lookup rather than printing the wrong card.

File size (for GitHub)

normal and large are JPEG, which keeps a full ~100-card EDH deck small enough to commit to a repo:

Use normal for anything you'll upload; use large for the nicest home prints.

Private Archidekt decks

Public and unlisted decks need no login. For a private deck, provide your Archidekt credentials via environment variables or a .env file (copy .env.example):

ARCHIDEKT_USERNAME=your-username
ARCHIDEKT_PASSWORD=your-password

The tool tries anonymously first and only logs in (JWT) if the deck isn't publicly accessible.

MCP server

The same functionality is exposed as an MCP tool so an agent (Claude Desktop, Claude Code, etc.) can generate proxy sheets.

Run it over stdio:

node mcp.js        # or: npm run mcp   (also installed as the `mtg-export-mcp` bin)

Register it with an MCP client, e.g. Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "mtg-export": {
      "command": "node",
      "args": ["/absolute/path/to/mtg-export/mcp.js"],
      "env": {
        "ARCHIDEKT_USERNAME": "your-username",
        "ARCHIDEKT_PASSWORD": "your-password"
      }
    }
  }
}

(env is only needed for private decks.)

It provides one tool, create_proxy_pdf:

It writes the PDF to disk and returns the path plus a summary (cards resolved, basics excluded, pages, size, any unresolved names).

Test with the MCP Inspector

Copy .env.example to .env and fill in your credentials (only needed for private decks):

cp .env.example .env

Run the inspector against the server:

npm run inspect
# equivalently:
npx @modelcontextprotocol/inspector node mcp.js

This opens a local web UI where you can list the tool and call create_proxy_pdf interactively.

How it works

1. Input → a list of {name, quantity, printing} entries (Archidekt deck, text file, or clipboard).

2. Resolve → Scryfall. Archidekt entries carry the exact printing's Scryfall id, so images are batch-resolved directly; text entries resolve by set+collector / name+set / name.

3. Cache → every downloaded image is stored under the cache dir and reused.

4. Render → pdf-lib lays out a 3×3 grid at true card size with cut guides; double-faced cards contribute a front and a back slot.

Notes

• Basic lands are excluded by default

• Deck quantities are printed by default; use --single for one of each.

• Foil is cosmetic for proxies — the printing is respected but the same art is used.