{"openapi":"3.1.0","info":{"title":"Drafting API","version":"0.1.0","description":"A fully local, hand-curated deck-building and card-drafting mechanics reference: engine-building deck construction, pick-and-pass / pack-based drafting, pool-building, hand-building, tableau building, and more, explained generically with real games referenced factually as examples. Original commentary, not a card database.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://drafting.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/drafting/docs"},"termsOfService":"https://connectorbay.com/drafting/terms"},"servers":[{"url":"https://drafting.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/drafting/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 deck-building or card-drafting mechanic: how it works, strategic notes, common","description":"Full detail for one deck-building or card-drafting mechanic: how it works, strategic notes, common\n    variants, related mechanics, and real games that use it. Use for \"what is engine building\", \"explain tableau\n    building\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A deck-building/drafting mechanic's name or alias.","examples":["engine building","pool building","tableau building","deck thinning"],"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/draft_format_explainer":{"post":{"operationId":"draft_format_explainer","summary":"Full detail for one drafting FORMAT — the structural pattern drafting itself takes (pick-and-pass, snake,","description":"Full detail for one drafting FORMAT — the structural pattern drafting itself takes (pick-and-pass, snake,\n    rotisserie, Winston, market-row, simultaneous, auction, grid): how it works, typical player counts, pros and\n    cons, and real games that use it. Use for \"what's a snake draft\", \"explain Winston draft\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A drafting format's name or alias.","examples":["pick and pass","snake draft","winston draft","market row"],"minLength":1,"title":"Format","type":"string"}},"required":["format"],"title":"draft_format_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_curve_tip":{"post":{"operationId":"deck_curve_tip","summary":"Generic, game-agnostic advice for building a good deck once you're playing: curve shape, early-game","description":"Generic, game-agnostic advice for building a good deck once you're playing: curve shape, early-game\n    priority, avoiding too many finishers, thinning, synergy vs. raw power, splashing, and more. Player-facing —\n    for GAME-design advice instead, use design_tip. Omit topic-matching text to browse; pass a topic to look one\n    up. Use for \"tips for a good deck curve\", \"how many finishers should I take\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"A deck-building topic to get player-facing advice on.","examples":["curve basics","early game priority","synergy vs power","splashing"],"minLength":1,"title":"Topic","type":"string"}},"required":["topic"],"title":"deck_curve_tipArguments","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 deck-building/drafting terms — curve, signal, archetype, synergy, engine, tempo,","description":"Definitions of common deck-building/drafting terms — curve, signal, archetype, synergy, engine, tempo,\n    bomb, splash, hate pick, wheel, cube, P1P1, and more. Use for \"what does archetype mean\", \"what's a hate\n    pick\".","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":"Real games (Dominion, Magic: The Gathering, 7 Wonders, and more) referenced factually as examples of one","description":"Real games (Dominion, Magic: The Gathering, 7 Wonders, and more) referenced factually as examples of one\n    named mechanic or draft format in action. Not a card database — just which known games use a pattern. Use for\n    \"what games use engine building\", \"give me examples of pick-and-pass drafting\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mechanic":{"description":"A mechanic or draft-format name to find real games for.","examples":["engine building","pick and pass drafting","market row"],"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/design_tip":{"post":{"operationId":"design_tip","summary":"Generic advice for DESIGNING a drafting or deck-building game: pack composition, archetype support, bomb","description":"Generic advice for DESIGNING a drafting or deck-building game: pack composition, archetype support, bomb\n    balance, signal clarity, catch-up mechanisms, interaction design, onboarding new players, and more.\n    Designer-facing — for player-facing deck-building advice instead, use deck_curve_tip. Use for \"how many bomb\n    cards should a draft format have\", \"how do I stop a runaway leader in a deckbuilder\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"A game-design topic to get designer-facing advice on.","examples":["pack composition","bomb balance","runaway leader","onboarding"],"minLength":1,"title":"Topic","type":"string"}},"required":["topic"],"title":"design_tipArguments","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_game_for_group":{"post":{"operationId":"find_game_for_group","summary":"Real deck-building/drafting games that fit a given player count, referenced factually, tightest-fitting","description":"Real deck-building/drafting games that fit a given player count, referenced factually, tightest-fitting\n    first. Use for \"good deckbuilder for 2 players\", \"drafting game for a group of 6\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many players will be playing.","maximum":12,"minimum":1,"title":"Player Count","type":"integer"}},"required":["player_count"],"title":"find_game_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/category_list":{"post":{"operationId":"category_list","summary":"Every collection in this reference (mechanics, draft formats, glossary terms, design tips, curve tips,","description":"Every collection in this reference (mechanics, draft formats, glossary terms, design tips, curve tips,\n    games) with how many entries each has. Use for \"what do you cover\", \"how many mechanics do you know\".","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}}}}