Reported issues for MTG MCP Server

Pod holds 15 of 15 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to MTG MCP Server.

Most discussed

Add docs/README.md with table of contents and navigation

GitHub renders README.md automatically when browsing into a folder. Adding one to docs/ would make the existing documentation much easier to navigate without any external tooling.

Scope

• Add docs/README.md with a brief description of each doc and links
• Keep it simple — just a TOC, not a wiki mirror or static site

Docs to index

• ARCHITECTURE.md — System architecture, FastMCP patterns, project structure
• TOOL_DESIGN.md — Full tool catalog (51 tools, 17 prompts, 18 resource

Read the thread · 2026-03-29 · closed · 3 comments

Reduce oversized MCP tool responses that overwhelm LLM context

Problem

Several tools return responses large enough to trigger "large MCP response" warnings in Claude Code and other MCP clients. While the ResponseLimitingMiddleware(max_size=500_000) prevents catastrophic blowups, responses in the 50-200KB range still consume excessive LLM context window space.

Offending Tools (by severity)

1. draft_card_ratings — worst offender

• Returns every card in a set with full model_dump(mode="json") in structured_content
• FDN has ~300 cards

Read the thread · 2026-03-29 · closed · 3 comments

budget_upgrade times out: uncapped live Scryfall price lookups trip 429 rate limit

Area

Scryfall tools (scryfall_*)

Description

I was trying out your tool, and ran into some issues. I did some digging and took a stab at fixing them. Here's what's going on:

Summary

budget_upgrade fetches a live Scryfall price for every EDHREC staple for a commander uncapped, often 150–300+ cards via individual /cards/named API calls, fully serialized by ScryfallClient's internal rate limiter.

This trips Scryfall's rate-limit partway through the run, and because the b

Read the thread · 2026-08-04 · open · external user · 1 comment

Add Moxfield public decklist provider

New data source: Moxfield public decklist provider

Category: New data source (integrate a new API or dataset)

Use Case

As a player or workflow tool that has a Moxfield deck URL (e.g., from Spicerack tournament results), I want to resolve that URL into an actual card list so that downstream tools (deck_analysis, deck_validate, suggest_cuts, suggest_mana_base, sideboard analysis) can operate on it.

Moxfield is the dominant deck-sharing platform for competitive Magic. Spicerack

Read the thread · 2026-04-02 · closed · 1 comment

theme_search returns name-literal matches instead of oracle text pattern matches

Problem

theme_search(theme="sacrifice", format="commander", limit=5) returns only 4 cards — all literally named "Sacrifice" (or containing it in the name):

• Sacrifice
• Louisoix's Sacrifice
• Implements of Sacrifice
• Nahiri's Sacrifice

It should be returning cards with sacrifice mechanics in their oracle text — things like Viscera Seer, Phyrexian Altar, Goblin Bombardment, Blood Artist, etc.

Expected Behavior

Theme search should map themes to oracle text patterns. For "sacrifice

Read the thread · 2026-03-29 · closed · 1 comment

sealed_pool_build errors with "Bulk metadata missing 'download_uri'"

Area

Draft/limited workflows

Description

sealed_pool_build doesn't work.

Steps to Reproduce

1. Ask the assistant to rate a card pool.
2. Make sure it uses sealed_pool_build.

Expected Behavior

sealed_pool_build works.

Actual Behavior

It errors with:

Error
sealed_pool_build failed: Bulk metadata missing 'download_uri'. Keys: ['object', 'id', 'type', 'updated_at', 'uri', 'name', 'description', 'jsonl_download_uri', 'compressed_size']

mtg-mcp-server versi

Read the thread · 2026-08-16 · open · external user · 0 comments

suggest_sideboard ignores deck color identity, suggests off-color cards

Summary

suggest_sideboard recommends cards outside the deck's color identity, treating role categories ("graveyard hate", "artifact removal", etc.) as the dominant filter and ignoring the main-deck color constraint.

Per #50 spec, the heuristic path is explicitly: "analyze main deck colors → suggest format-appropriate hate cards from Scryfall bulk data". The color-analysis step appears to be missing or downstream of category selection.

Reproduction

Mono-Izzet (UR) deck — no white, b

Read the thread · 2026-05-03 · open · 0 comments

sideboard_matrix returns FLEX for every card across every matchup

Summary

sideboard_matrix produces output where every cell is FLEX, regardless of card or matchup. The matrix is well-formed (correct columns, auto-detected matchups from metagame data) but the per-cell IN/OUT/FLEX classification is uniform, making the output non-actionable.

Per #50 spec, cells should indicate IN (bring in), OUT (cut), or FLEX (context-dependent). In practice everything resolves to FLEX.

Reproduction

Tuned Legacy Izzet Tempo list with a Legacy-typical sidebo

Read the thread · 2026-05-03 · open · 0 comments

Most recent

FYI: Urza capapp built on top — adding brewing workflow layer

Hey Justin — wanted to say thanks for mtg-mcp-server and give you a heads-up that I've built a small capapp on top of it.

Urza is a thin Commander brewing workflow layer that mounts mtg-mcp-server as a library and adds four things on top:

1. Pairwise interaction-density scoring — scores every card pair on provides/needs/traits overlap using Scryfall types + your Spellbook combo graph. Discriminates tribal (~0.5/pair) from combo-heavy (~1.5+/pair) deck

Read the thread · 2026-04-23 · open · external user · 0 comments

Add sideboard analysis tools for Bo3 constructed formats

New tools: Sideboard analysis for Bo3 constructed formats

Category: New workflow (compose multiple backends)

Use Case

As a Bo3 constructed player (Pauper, Modern, Pioneer, Legacy), I want sideboard guidance — what cards to include, what to board in/out per matchup, and how my 75 should adapt to the expected meta. Sideboarding is roughly half the skill expression in competitive Bo3, and the server currently has zero sideboard awareness.

This gap exists because the server was buil

Read the thread · 2026-04-02 · closed · 0 comments

Add constructed metagame workflow tools

New workflows: Constructed metagame tools

Category: New workflow (compose multiple backends)

Use Case

As a player exploring a new constructed format (Pauper, Modern, Pioneer, etc.), I want to ask "what does this format look like?" and "give me the stock list for Mono-Blue Terror" and get actionable answers — the same way commander_overview gives a full profile for a Commander deck.

The server currently has zero workflow-level support for constructed metagame questions. All exi

Read the thread · 2026-04-02 · closed · 0 comments

Fix bulk_format_staples Commander bias for constructed formats

Enhancement: Fix bulk_format_staples Commander bias for constructed formats

Category: Enhancement (improve an existing tool or workflow)

Use Case

As a Pauper player, when I ask for format staples via bulk_format_staples(format="pauper"), I expect to see Lightning Bolt, Counterspell, Preordain, Cast Down — cards that are actually defining the Pauper metagame. Instead, I get Command Tower, Arcane Signet, Path of Ancestry, and Cultivate — cards that are popular in Commander but irre

Read the thread · 2026-04-02 · closed · 0 comments

Add MTGGoldfish metagame provider

New data source: MTGGoldfish metagame provider

Category: New data source (integrate a new API or dataset)

Use Case

As a constructed format player, I want to see metagame breakdowns — archetype names, meta share percentages, stock decklists, and format staple rankings — so I can understand what decks exist, how popular they are, and what a typical list looks like before I start building.

MTGGoldfish is the most widely-used metagame resource across all constructed formats. It provides

Read the thread · 2026-04-02 · closed · 0 comments

Add Spicerack tournament results provider

New data source: Spicerack tournament results provider

Category: New data source (integrate a new API or dataset)

Use Case

As a constructed format player, I want access to tournament decklists and results so that metagame analysis, archetype identification, and sideboard tools have real competitive data to work with. The server currently has zero constructed metagame coverage — EDHREC serves Commander, 17Lands serves draft, but Pauper/Modern/Pioneer/Legacy have no data pipeline.

Spi

Read the thread · 2026-04-02 · closed · 0 comments

Investigate enhanced Claude Code review with file-reading tools

Context

PR #38 was the first PR to trigger the Claude Code review bot. It posted "No issues found" on a 6,800-line diff — the review config was too weak (plugin delegation, no direct prompt, restricted tools).

Fixed in this PR: switched from plugin-based to direct prompt with project-specific review criteria (official Anthropic approach).

Investigation items

If the official approach still produces shallow reviews, consider:

1. Add file-reading tools (Read, Glob, Grep in `--a

Read the thread · 2026-03-29 · closed · 0 comments

The remaining reports are on the project's issue tracker.