MCP 服务器

MTG Bench

com.mtgbench/mtgbench
游戏 知识与文档 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Searches Magic: The Gathering cards and rules and analyzes, validates, upgrades, and finds combos in decks.

check_deck_legality
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).
只读
输入模式
{'type': 'object', 'required': ['format', 'cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer'}}, 'additionalProperties': False}}, 'format': {'type': 'string'}, 'commander': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['legal'], 'properties': {'legal': {'type': 'boolean'}, 'notes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'violations': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}
commander_staples
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.
只读
输入模式
{'type': 'object', 'required': ['commander'], 'properties': {'limit': {'type': 'integer'}, 'commander': {'type': 'string'}, 'minSynergy': {'type': 'number'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['commander', 'totalDecks', 'cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['card', 'decks', 'pctOfDecks'], 'properties': {'card': {'type': 'string'}, 'decks': {'type': 'integer'}, 'synergy': {'type': 'number'}, 'category': {'type': 'string'}, 'pctOfDecks': {'type': 'number'}}, 'additionalProperties': False}}, 'commander': {'type': 'string'}, 'totalDecks': {'type': 'integer'}}, 'additionalProperties': False}
deck_stats
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.
只读
输入模式
{'type': 'object', 'required': ['cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer'}}, 'additionalProperties': False}}, 'format': {'type': 'string'}, 'commander': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['totalCards', 'landCount', 'nonlandCount', 'targetSize', 'avgManaValue', 'medianManaValue', 'curve', 'types', 'pips', 'sources', 'landSources', 'rockSources', 'dorkSources', 'buckets', 'openingHand', 'suggestedLands'], 'properties': {'brew': {'type': ['null', 'object'], 'required': ['avgInclusionPct', 'stapleCount', 'uniqueCount', 'nonlandUnique', 'brewScore'], 'properties': {'brewScore': {'type': 'integer'}, 'topStaples': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'stapleCount': {'type': 'integer'}, 'uniqueCount': {'type': 'integer'}, 'nonlandUnique': {'type': 'integer'}, 'avgInclusionPct': {'type': 'number'}}, 'additionalProperties': False}, 'pips': {'type': 'object', 'additionalProperties': {'type': 'number'}}, 'curve': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'creatures', 'nonCreatures'], 'properties': {'label': {'type': 'string'}, 'creatures': {'type': 'integer'}, 'nonCreatures': {'type': 'integer'}}, 'additionalProperties': False}}, 'notes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'price': {'type': ['null', 'object'], 'required': ['total'], 'properties': {'top': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'price'], 'properties': {'name': {'type': 'string'}, 'price': {'type': 'number'}}, 'additionalProperties': False}}, 'total': {'type': 'number'}, 'unpricedCount': {'type': 'integer'}, 'commanderPrice': {'type': 'number'}}, 'additionalProperties': False}, 'types': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'buckets': {'type': 'object', 'required': ['rampRocks', 'rampDorks', 'rampLand', 'rituals', 'cardDraw', 'creatureRemoval', 'artEnchRemoval', 'flexibleRemoval', 'boardWipes', 'counterspells', 'recursion', 'protection', 'tutors', 'fastMana', 'freeInteraction', 'extraTurns', 'massLandDenial', 'gameChangers', 'winTheGame', 'interactionTotal', 'rampTotal'], 'properties': {'tutors': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'rituals': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'cardDraw': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'fastMana': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'rampLand': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'rampDorks': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'rampRocks': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'rampTotal': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'recursion': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'boardWipes': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'extraTurns': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'protection': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'winTheGame': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'gameChangers': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'counterspells': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'artEnchRemoval': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'massLandDenial': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'creatureRemoval': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'flexibleRemoval': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'freeInteraction': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}, 'interactionTotal': {'type': 'object', 'required': ['count'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'count': {'type': 'integer'}, 'bandMax': {'type': 'integer'}, 'bandMin': {'type': 'integer'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'sources': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'identity': {'type': ['null', 'object'], 'required': ['colors', 'archetype', 'sentence'], 'properties': {'colors': {'type': 'string'}, 'themes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['theme', 'score'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'score': {'type': 'integer'}, 'theme': {'type': 'string'}}, 'additionalProperties': False}}, 'sentence': {'type': 'string'}, 'archetype': {'type': 'string'}, 'offIdentityCards': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'landCount': {'type': 'integer'}, 'targetSize': {'type': 'integer'}, 'totalCards': {'type': 'integer'}, 'bandBracket': {'type': 'integer'}, 'dorkSources': {'type': 'integer'}, 'landSources': {'type': 'integer'}, 'openingHand': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['label', 'pct'], 'properties': {'pct': {'type': 'number'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'rockSources': {'type': 'integer'}, 'topKeywords': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['keyword', 'count'], 'properties': {'count': {'type': 'integer'}, 'keyword': {'type': 'string'}}, 'additionalProperties': False}}, 'topSubtypes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['subtype', 'count'], 'properties': {'count': {'type': 'integer'}, 'subtype': {'type': 'string'}}, 'additionalProperties': False}}, 'avgManaValue': {'type': 'number'}, 'nonlandCount': {'type': 'integer'}, 'unknownCards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'suggestedLands': {'type': 'integer'}, 'medianManaValue': {'type': 'number'}}, 'additionalProperties': False}
find_combos
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.
只读
输入模式
{'type': 'object', 'required': ['cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer'}}, 'additionalProperties': False}}, 'limit': {'type': 'integer'}, 'format': {'type': 'string'}, 'commander': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'notes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'combos': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'url', 'cards'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'identity': {'type': 'string'}, 'produces': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'requires': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'description': {'type': 'string'}}, 'additionalProperties': False}}, 'nearMisses': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'url', 'cards', 'missingCard'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'cards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'identity': {'type': 'string'}, 'produces': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'requires': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'description': {'type': 'string'}, 'missingCard': {'type': 'string'}, 'missingCardPrice': {'type': ['null', 'number']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
find_synergies
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.
只读
输入模式
{'type': 'object', 'required': ['cardNames'], 'properties': {'limit': {'type': 'integer'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'colors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'format': {'type': 'string'}, 'cardNames': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'manaValueMax': {'type': ['null', 'number']}, 'manaValueMin': {'type': ['null', 'number']}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'name', 'typeLine', 'score'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'score': {'type': 'number'}, 'reason': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'manaCost': {'type': 'string'}, 'typeLine': {'type': 'string'}, 'oracleText': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_card
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).
只读
输入模式
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['card'], 'properties': {'card': {'type': 'object', 'required': ['id', 'name', 'typeLine'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'power': {'type': 'string'}, 'colors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'loyalty': {'type': 'string'}, 'rulings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'text'], 'properties': {'date': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': False}}, 'imageUrl': {'type': 'string'}, 'keywords': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'manaCost': {'type': 'string'}, 'typeLine': {'type': 'string'}, 'manaValue': {'type': ['null', 'number']}, 'printings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['setCode', 'number', 'rarity'], 'properties': {'number': {'type': 'string'}, 'rarity': {'type': 'string'}, 'setCode': {'type': 'string'}}, 'additionalProperties': False}}, 'toughness': {'type': 'string'}, 'legalities': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'oracleText': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_card_image
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).
只读
输入模式
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'setCode': {'type': 'string'}, 'version': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['name', 'setCode', 'imageUrl'], 'properties': {'name': {'type': 'string'}, 'setCode': {'type': 'string'}, 'imageUrl': {'type': 'string'}}, 'additionalProperties': False}
get_card_printings
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.
只读
输入模式
{'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['printings'], 'properties': {'printings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'setCode', 'number', 'rarity', 'isPromo', 'isReprint'], 'properties': {'id': {'type': 'string'}, 'artist': {'type': 'string'}, 'number': {'type': 'string'}, 'rarity': {'type': 'string'}, 'isPromo': {'type': 'boolean'}, 'setCode': {'type': 'string'}, 'finishes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'imageUrl': {'type': 'string'}, 'isReprint': {'type': 'boolean'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_card_rulings
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.
只读
输入模式
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['card', 'rulings', 'count'], 'properties': {'card': {'type': 'string'}, 'count': {'type': 'integer'}, 'rulings': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['date', 'text'], 'properties': {'date': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_rule
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.
只读
输入模式
{'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['rules'], 'properties': {'rules': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'ref', 'text'], 'properties': {'ref': {'type': 'string'}, 'kind': {'type': 'string'}, 'text': {'type': 'string'}, 'score': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
my_collection
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>").
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['distinctCards', 'totalCopies', 'source'], 'properties': {'source': {'type': 'string'}, 'totalCopies': {'type': 'integer'}, 'distinctCards': {'type': 'integer'}}, 'additionalProperties': False}
rate_deck
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.
只读
输入模式
{'type': 'object', 'required': ['cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer'}}, 'additionalProperties': False}}, 'commander': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['bracketFloor', 'bracketFloorReason', 'signals', 'deck', 'rubric', 'assessmentGuidance'], 'properties': {'deck': {'type': 'object', 'required': ['totalCards', 'landCount', 'manaCurve', 'colorDistribution', 'typeCounts', 'avgManaValue'], 'properties': {'landCount': {'type': 'integer'}, 'manaCurve': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'totalCards': {'type': 'integer'}, 'typeCounts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'topKeywords': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'topSubtypes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'avgManaValue': {'type': 'number'}, 'colorDistribution': {'type': 'object', 'additionalProperties': {'type': 'integer'}}}, 'additionalProperties': False}, 'notes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'rubric': {'type': 'string'}, 'signals': {'type': 'object', 'properties': {'fastMana': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'extraTurns': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'winTheGame': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'gameChangers': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'nonlandTutors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'massLandDenial': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'freeInteraction': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'earlyCombo': {'type': 'string'}, 'bracketFloor': {'type': 'integer'}, 'unknownCards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'combosPresent': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'assessmentGuidance': {'type': 'string'}, 'bracketFloorReason': {'type': 'string'}}, 'additionalProperties': False}
resolve_card_names
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.
只读
输入模式
{'type': 'object', 'properties': {'text': {'type': 'string'}, 'names': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['results', 'found', 'notFound'], 'properties': {'found': {'type': 'integer'}, 'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['input', 'status'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'input': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': False}}, 'notFound': {'type': 'integer'}}, 'additionalProperties': False}
search_cards
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.
只读
输入模式
{'type': 'object', 'properties': {'name': {'type': 'string'}, 'sets': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'limit': {'type': 'integer'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'colors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'format': {'type': 'string'}, 'supertypes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'manaValueMax': {'type': ['null', 'number']}, 'manaValueMin': {'type': ['null', 'number']}, 'colorIdentity': {'type': ['null', 'array'], 'items': {'type': 'string'}}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'name', 'typeLine'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'manaCost': {'type': 'string'}, 'typeLine': {'type': 'string'}, 'oracleText': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_my_collection
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>").
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'colors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'notInDecks': {'type': 'boolean'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['cards', 'total'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'typeLine', 'quantity', 'inDeck'], 'properties': {'name': {'type': 'string'}, 'inDeck': {'type': 'boolean'}, 'manaCost': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'typeLine': {'type': 'string'}}, 'additionalProperties': False}}, 'total': {'type': 'integer'}}, 'additionalProperties': False}
search_rules
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.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'kinds': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'limit': {'type': 'integer'}, 'query': {'type': 'string'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['kind', 'ref', 'text'], 'properties': {'ref': {'type': 'string'}, 'kind': {'type': 'string'}, 'text': {'type': 'string'}, 'score': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
semantic_card_search
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.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer'}, 'query': {'type': 'string'}, 'types': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'colors': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'format': {'type': 'string'}, 'manaValueMax': {'type': ['null', 'number']}, 'manaValueMin': {'type': ['null', 'number']}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'name', 'typeLine', 'score'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'score': {'type': 'number'}, 'reason': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'manaCost': {'type': 'string'}, 'typeLine': {'type': 'string'}, 'oracleText': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
upgrade_deck
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.
只读
输入模式
{'type': 'object', 'required': ['format', 'cards'], 'properties': {'cards': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'count'], 'properties': {'name': {'type': 'string'}, 'count': {'type': 'integer'}}, 'additionalProperties': False}}, 'budget': {'type': ['null', 'number']}, 'format': {'type': 'string'}, 'maxAdds': {'type': 'integer'}, 'maxCuts': {'type': 'integer'}, 'strategy': {'type': 'string'}, 'commander': {'type': 'string'}, 'ownedOnly': {'type': 'boolean'}, 'maxCardPrice': {'type': ['null', 'number']}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['phase'], 'properties': {'adds': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'price', 'provider', 'reason', 'score'], 'properties': {'name': {'type': 'string'}, 'price': {'type': 'number'}, 'score': {'type': 'number'}, 'reason': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'provider': {'type': 'string'}}, 'additionalProperties': False}}, 'cuts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['name', 'reason'], 'properties': {'name': {'type': 'string'}, 'reason': {'type': 'string'}}, 'additionalProperties': False}}, 'deck': {'type': ['null', 'object'], 'required': ['totalCards', 'landCount', 'manaCurve', 'colorDistribution', 'typeCounts', 'avgManaValue'], 'properties': {'landCount': {'type': 'integer'}, 'manaCurve': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'totalCards': {'type': 'integer'}, 'typeCounts': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'topKeywords': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'topSubtypes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'avgManaValue': {'type': 'number'}, 'colorDistribution': {'type': 'object', 'additionalProperties': {'type': 'integer'}}}, 'additionalProperties': False}, 'notes': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'phase': {'type': 'string'}, 'strategy': {'type': 'string'}, 'totalCost': {'type': ['null', 'number']}, 'unknownCards': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'collectionTip': {'type': ['null', 'object'], 'required': ['message', 'url'], 'properties': {'url': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, 'legalityIssues': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'strategyPrompt': {'type': 'string'}, 'budgetRemaining': {'type': ['null', 'number']}}, 'additionalProperties': False}
what_can_i_build
Given the user's imported card collection, rank the Commander decks they can most nearly build right now, with the most-played cards they are still missing. Answers "what should I sleeve up tonight" from cards they physically have. Requires a free API key (send it as "X-API-Key: <key>" or "Authorization: Bearer <key>") so the server knows whose collection to read; one is issued instantly at https://mtgbench.com/account/api-keys.
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'missing': {'type': 'integer'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['commanders', 'note'], 'properties': {'note': {'type': 'string'}, 'commanders': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['commander', 'coveragePct', 'ownedCore', 'coreSize', 'edhrecDeckCount'], 'properties': {'coreSize': {'type': 'integer'}, 'commander': {'type': 'string'}, 'ownedCore': {'type': 'integer'}, 'missingTop': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'coveragePct': {'type': 'number'}, 'edhrecDeckCount': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
已添加
what_can_i_build
2026年9月17日 12:36
已添加
upgrade_deck
2026年9月17日 12:36
已添加
semantic_card_search
2026年9月17日 12:36
已添加
search_rules
2026年9月17日 12:36
已添加
search_my_collection
2026年9月17日 12:36
已添加
search_cards
2026年9月17日 12:36
已添加
resolve_card_names
2026年9月17日 12:36
已添加
rate_deck
2026年9月17日 12:36
已添加
my_collection
2026年9月17日 12:36
已添加
get_rule
2026年9月17日 12:36
已添加
get_card_rulings
2026年9月17日 12:36
已添加
get_card_printings
2026年9月17日 12:36
已添加
get_card_image
2026年9月17日 12:36
已添加
get_card
2026年9月17日 12:36
已添加
find_synergies
2026年9月17日 12:36
已添加
find_combos
2026年9月17日 12:36
已添加
deck_stats
2026年9月17日 12:36
已添加
commander_staples
2026年9月17日 12:36
已添加
check_deck_legality
2026年9月17日 12:36