Connection check
verified live · 20h ago
mtgbench
Magic: The Gathering card search, rules, rulings, deck analysis, brackets, and combo detection.
Tools
19
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
19 toolsRead from the running server on 20h ago.
check_deck_legality
read-only
cards*format*commander
Validate a decklist against a constructed format's rules (banned cards, deck size, copy limits, and in Commander the color-identity rule). Use this rather than recalling ban lists… Validate a decklist against a constructed format's rules (banned cards, deck size, copy limits, and in Commander the color-identity rule). Use this rather than recalling ban lists from memory: bans changed four times in 2026 alone, and a model's training cutoff makes stale ban data one of the most common wrong answers in Magic. Pass `commander` for Commander decks: it counts toward the 100, and it is what makes the color-identity check possible (without it the response says color identity went unchecked).
commander_staples
read-only
limitcommander*minSynergy
The cards most commonly played with a given commander, from EDHREC's aggregate inclusion data: 691,958 commander-card pairings across 2,631 commanders. Returns each card's deck cou… The cards most commonly played with a given commander, from EDHREC's aggregate inclusion data: 691,958 commander-card pairings across 2,631 commanders. Returns each card's deck count, the share of that commander's decks running it, and its synergy score. Synergy matters as much as popularity: a high deck count with LOW synergy is a card everyone plays anyway (Sol Ring), while high synergy is a card that is unusually good with this commander specifically. Lead with the latter when recommending. Use this to ground deckbuilding in what people actually play instead of guessing.
deck_stats
read-only
cards*formatcommander
Deterministic statistical analysis of a decklist (any format): mana curve with creature split, card types, color pips vs mana sources, functional buckets (ramp/draw/removal/wipes/c… Deterministic statistical analysis of a decklist (any format): mana curve with creature split, card types, color pips vs mana sources, functional buckets (ramp/draw/removal/wipes/counters/recursion/protection/tutors + bracket signals) with typical Commander bands, opening-hand probabilities (hypergeometric), a suggested land count, meta brew score, deck price, tribal and keyword counts. Pure data — no judgment calls.
find_combos
read-only
cards*limitformatcommander
Detect known combos in a decklist using Commander Spellbook's curated database — combos fully present, plus near-misses one card away (with that card's price). Pass `format` (and `… Detect known combos in a decklist using Commander Spellbook's curated database — combos fully present, plus near-misses one card away (with that card's price). Pass `format` (and `commander` for Commander) so near-miss suggestions are filtered to legal, in-color-identity adds. Use this instead of recalling combos from memory; also feeds rate_deck's compact-combo check.
find_synergies
read-only
limittypescolorsformatcardNames*manaValueMax
+1
Given one or more cards the user ALREADY has, find cards that work with them. Seeded by example rather than by description: pass the cards, get partners. Use semantic_card_search i… Given one or more cards the user ALREADY has, find cards that work with them. Seeded by example rather than by description: pass the cards, get partners. Use semantic_card_search instead to describe a desired effect in words, and search_cards for structured filters. `limit` defaults to 10 and caps at 100 per call.
get_card
read-only
idnameslug
Fetch full detail for ONE card by exact name or id: oracle text, mana cost, type line, format legalities, and a brief summary of its printings. Use get_card_printings instead when… Fetch full detail for ONE card by exact name or id: oracle text, mana cost, type line, format legalities, and a brief summary of its printings. Use get_card_printings instead when the complete printing list matters (choosing a specific art, set, or finish).
get_card_image
read-only
idnamesetCodeversion
Fetch a card's image. The returned image content block IS the display — the client renders it directly; do not build custom HTML/widgets around the imageUrl, since sandboxed widget… Fetch a card's image. The returned image content block IS the display — the client renders it directly; do not build custom HTML/widgets around the imageUrl, since sandboxed widget environments block external image hosts. Optionally pick a specific printing (setCode) or size (small, normal, large, png, art_crop, border_crop, or WEBP: thumb, grid, display).
get_card_printings
read-only
idnameslug
List EVERY printing of a card (set, rarity, artist, finish, collector number). get_card already returns a short printings summary, so reach for this only when the full list is the… List EVERY printing of a card (set, rarity, artist, finish, collector number). get_card already returns a short printings summary, so reach for this only when the full list is the point.
get_card_rulings
read-only
name*
Fetch the OFFICIAL Wizards rulings for one card, with their dates. These are Wizards' own answers to the corner cases players argue about. Use this for any "how does this card actu… Fetch the OFFICIAL Wizards rulings for one card, with their dates. These are Wizards' own answers to the corner cases players argue about. Use this for any "how does this card actually work" question, and quote the ruling rather than paraphrasing from memory — rulings are among the most frequently hallucinated things in Magic. Use search_rules instead for general mechanics not tied to a specific card.
get_rule
read-only
ref*
Fetch a Comprehensive Rules entry and its lettered subrules by exact number (e.g. "601.2" returns 601.2 and 601.2a-i). Use after search_rules to read a rule's full context. Fetch a Comprehensive Rules entry and its lettered subrules by exact number (e.g. "601.2" returns 601.2 and 601.2a-i). Use after search_rules to read a rule's full context.
my_collection
read-only
Summarize the user's imported collection: how many distinct cards, total copies, and where it was imported from. This is the SUMMARY only. Use search_my_collection to look up indiv… Summarize the user's imported collection: how many distinct cards, total copies, and where it was imported from. This is the SUMMARY only. Use search_my_collection to look up individual owned cards, and what_can_i_build to rank commanders they could assemble. Requires a free API key (send it as "X-API-Key: <key>" or "Authorization: Bearer <key>").
rate_deck
read-only
cards*commander
Assess a Commander deck's official WotC bracket (1-5). Returns deterministic signals (Game Changers from WotC's curated list, mass land denial, tutors, fast mana, free interaction)… Assess a Commander deck's official WotC bracket (1-5). Returns deterministic signals (Game Changers from WotC's curated list, mass land denial, tutors, fast mana, free interaction), a bracket FLOOR from the official decision tree, and the rubric — then YOU finish the assessment: check for compact two-card win combos and weigh soft signals per the assessmentGuidance, and state the final bracket with evidence.
resolve_card_names
read-only
textnames
Check whether card names are REAL, in bulk. Returns exact / not_found per name, with the canonical spelling and id for the ones that exist. Call this reflexively before presenting… Check whether card names are REAL, in bulk. Returns exact / not_found per name, with the canonical spelling and id for the ones that exist. Call this reflexively before presenting any decklist or card recommendation you generated: the most common failure in Magic assistance is confidently naming cards that do not exist, or that exist with different text. Cheap, batched, and safe to call on every card you are about to mention. Accepts either a `names` array or a pasted `text` decklist.
search_cards
read-only
namesetslimittypescolorsformat
+4
Find cards by NAME or by structured filters (colors, color identity, types, mana value, format legality, sets). Use when the query can be expressed as filters: "red instants under… Find cards by NAME or by structured filters (colors, color identity, types, mana value, format legality, sets). Use when the query can be expressed as filters: "red instants under 3 mana", "legendary artifacts in Standard", "cards named Bolt". Use semantic_card_search instead when the user describes an EFFECT rather than a filter ("cards that make a treasure when I attack"). Use find_synergies instead when they name cards they already have and want things that pair with them. Searches every Magic card; use search_my_collection to search only what the user owns. `limit` defaults to 25 and caps at 100 per call.
search_my_collection
read-only
limitquerytypescolorsnotInDecks
Search only the cards the user OWNS, by name, colors, or type. Set notInDecks to surface owned cards not currently used in any of their decks (the "what is sitting idle in my binde… Search only the cards the user OWNS, by name, colors, or type. Set notInDecks to surface owned cards not currently used in any of their decks (the "what is sitting idle in my binder" question). Use search_cards instead to search every Magic card regardless of ownership. Returns at most 100 owned cards per call, with the full match count in `total`. Requires a free API key (send it as "X-API-Key: <key>" or "Authorization: Bearer <key>").
search_rules
read-only
kindslimitquery*
Semantic search over the Magic Comprehensive Rules, glossary, and 84k card-specific rulings. Use for any rules/interaction question; answer FROM the returned chunks and cite rule n… Semantic search over the Magic Comprehensive Rules, glossary, and 84k card-specific rulings. Use for any rules/interaction question; answer FROM the returned chunks and cite rule numbers (e.g. 601.2a). Filter kinds to ["ruling"] for card-specific questions or ["rule","glossary"] for general mechanics.
semantic_card_search
read-only
limitquery*typescolorsformatmanaValueMax
+1
Vector search over card TEXT, for describing an effect that cannot be written as a filter: "cards that make a token when I attack", "punish opponents for drawing", "does what Rhyst… Vector search over card TEXT, for describing an effect that cannot be written as a filter: "cards that make a token when I attack", "punish opponents for drawing", "does what Rhystic Study does but cheaper". This is a query Scryfall syntax cannot express. Use search_cards instead for structured filters (color, type, mana value, set). Use find_synergies instead when the user names specific cards and wants partners for them. `limit` defaults to 10 and caps at 100 per call.
upgrade_deck
read-only
cards*budgetformat*maxAddsmaxCutsstrategy
+3
Suggest priced deck upgrades: cards to add (within an optional budget) and cards to cut. TWO-PHASE: first call WITHOUT `strategy` to get a deck analysis and instructions for derivi… Suggest priced deck upgrades: cards to add (within an optional budget) and cards to cut. TWO-PHASE: first call WITHOUT `strategy` to get a deck analysis and instructions for deriving the deck's strategy; then call again WITH your derived `strategy` to get recommendations. Cuts are theme-alignment suggestions relative to the stated strategy, not card-quality judgments. Prices are Card Kingdom/TCGplayer retail USD.
what_can_i_build
read-only
limitmissing