# 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](/mcp/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](https://github.com/j4th/mtg-mcp-server/issues/42) · 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](https://github.com/j4th/mtg-mcp-server/issues/37) · 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](https://github.com/j4th/mtg-mcp-server/issues/68) · 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](https://github.com/j4th/mtg-mcp-server/issues/45) · 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](https://github.com/j4th/mtg-mcp-server/issues/39) · 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](https://github.com/j4th/mtg-mcp-server/issues/69) · 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](https://github.com/j4th/mtg-mcp-server/issues/64) · 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](https://github.com/j4th/mtg-mcp-server/issues/63) · 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](https://github.com/dreliq9/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](https://github.com/j4th/mtg-mcp-server/issues/62) · 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](https://github.com/j4th/mtg-mcp-server/issues/50) · 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](https://github.com/j4th/mtg-mcp-server/issues/49) · 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](https://github.com/j4th/mtg-mcp-server/issues/48) · 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](https://github.com/j4th/mtg-mcp-server/issues/47) · 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](https://github.com/j4th/mtg-mcp-server/issues/46) · 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](https://github.com/j4th/mtg-mcp-server/issues/40) · 2026-03-29 · closed · 0 comments The remaining reports are on [the project's issue tracker](https://github.com/j4th/mtg-mcp-server/issues).