{"openapi":"3.1.0","info":{"title":"Tradingcard API","version":"0.1.0","description":"A fully local, hand-curated, original cross-game reference for collectible/trading card game (CCG/TCG) mechanics: generic resource systems, card types, core mechanics, deck archetypes, rarity-tier systems, deck-construction rules, tournament formats, a jargon glossary and factual real-game cross-references.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tradingcard.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tradingcard/docs"},"termsOfService":"https://connectorbay.com/tradingcard/terms"},"servers":[{"url":"https://tradingcard.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tradingcard/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/mechanic_info":{"post":{"operationId":"mechanic_info","summary":"Full detail for one generic CCG/TCG mechanic — a resource system, a card type, a core gameplay mechanic, or","description":"Full detail for one generic CCG/TCG mechanic — a resource system, a card type, a core gameplay mechanic, or\n    a deck archetype: its summary, how it works, why games design it this way, and related terms. Use for \"what's\n    a mana curve\", \"explain the aggro archetype\", \"what's a keyword ability\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A mechanic's name or alias.","examples":["mana curve","board wipe","aggro","keyword ability"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"mechanic_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/mechanic_search":{"post":{"operationId":"mechanic_search","summary":"Keyword search across every mechanic's name, category, summary, details and related terms. Use for","description":"Keyword search across every mechanic's name, category, summary, details and related terms. Use for\n    \"mechanics about card advantage\", \"anything about hidden information\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"mechanic_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rarity_tier_explainer":{"post":{"operationId":"rarity_tier_explainer","summary":"Explains a named rarity-tier system tier by tier: the tiered common/uncommon/rare/mythic symbol system, the","description":"Explains a named rarity-tier system tier by tier: the tiered common/uncommon/rare/mythic symbol system, the\n    numbered-parallel/insert system used by sports and premium collectible cards, the digital crafting/dust-economy\n    system, or the short-print/secret-rarity system. Use for \"explain rarity tiers\", \"what's a secret rare\",\n    \"how does card rarity work in digital card games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system":{"description":"A rarity system's name or alias.","examples":["tiered symbol system","digital crafting","secret rare"],"minLength":1,"title":"System","type":"string"}},"required":["system"],"title":"rarity_tier_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/deck_construction_rule":{"post":{"operationId":"deck_construction_rule","summary":"Explains one deck-construction format's rules: deck size limits, per-card copy limits, and any extra card","description":"Explains one deck-construction format's rules: deck size limits, per-card copy limits, and any extra card\n    pools (sideboard, extra deck). Covers standard constructed, singleton/Highlander, limited draft pools, sealed\n    pools, cube pools, and pre-built no-construction decks. Use for \"how many cards in a constructed deck\", \"what's\n    the copy limit in singleton formats\", \"deck size for sealed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A deck-construction format's name or alias.","examples":["standard constructed","singleton","sealed","draft"],"minLength":1,"title":"Format","type":"string"}},"required":["format"],"title":"deck_construction_ruleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tournament_format_info":{"post":{"operationId":"tournament_format_info","summary":"Explains one tournament format: its structure, typical player-count range, typical round length, and what","description":"Explains one tournament format: its structure, typical player-count range, typical round length, and what\n    it's good for. Covers rotating and eternal constructed, booster draft, sealed deck, cube draft, multiplayer\n    pods, and the organized-play tier ladder. Use for \"what's booster draft\", \"how does sealed deck work\", \"what's\n    the organized play ladder look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A tournament format's name or alias.","examples":["booster draft","sealed deck","constructed","cube draft"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"tournament_format_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_format_for_group":{"post":{"operationId":"find_format_for_group","summary":"Suggests tournament formats whose typical player-count range fits a given group size, from 2-player","description":"Suggests tournament formats whose typical player-count range fits a given group size, from 2-player\n    constructed matches up to large multiplayer pods and organized-play events. Use for \"what format works for 6\n    people\", \"best tournament structure for a 4-player group\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many players are in the group.","examples":[2,4,8],"maximum":64,"minimum":1,"title":"Player Count","type":"integer"}},"required":["player_count"],"title":"find_format_for_groupArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of common CCG/TCG player jargon — topdeck, curve, meta/metagame, netdecking, tech choice,","description":"Definitions of common CCG/TCG player jargon — topdeck, curve, meta/metagame, netdecking, tech choice,\n    power creep, mana screw, flood, Swiss pairings, and more. Use for \"what does netdecking mean\", \"what's a\n    topdeck\", \"what's the difference between Swiss and single elimination\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"term_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/game_examples":{"post":{"operationId":"game_examples","summary":"Names real games that illustrate a given generic mechanic in practice — for example, which real games use","description":"Names real games that illustrate a given generic mechanic in practice — for example, which real games use\n    an automatic-growth resource system versus a land-equivalent card type, or which games popularized a\n    no-deckbuilding preset-deck model. Referenced factually as examples, never as a card database. Use for \"which\n    real games use a resource system like Magic's lands\", \"give me examples of the aggro archetype in real\n    games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mechanic":{"description":"A mechanic's name or alias to find real-game examples for.","examples":["resource system","aggro","board wipe"],"minLength":1,"title":"Mechanic","type":"string"}},"required":["mechanic"],"title":"game_examplesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/category_list":{"post":{"operationId":"category_list","summary":"An overview of everything this connector covers: mechanic categories with counts (Resource Systems, Card","description":"An overview of everything this connector covers: mechanic categories with counts (Resource Systems, Card\n    Types, Core Mechanics, Deck Archetypes), plus how many rarity systems, deck-construction formats, tournament\n    formats and glossary terms are available. Use for \"what do you cover\", \"what categories of mechanics do you\n    know about\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"category_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}