{"openapi":"3.1.0","info":{"title":"Deduction API","version":"0.1.0","description":"A fully local, hand-curated reference on how elimination-deduction games (the Clue/Cluedo-style genre) work generically: core mechanics (suggestions, disproving, process of elimination, accusations, notesheet tracking), logic-grid puzzle solving with a worked example, abstract category archetypes for building your own game, group-size format suggestions, difficulty-tuning tips, and step-by-step custom-game design guidance. Original generic content only, not any specific trademarked game's actual card set.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://deduction.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/deduction/docs"},"termsOfService":"https://connectorbay.com/deduction/terms"},"servers":[{"url":"https://deduction.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/deduction/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 explanation of one elimination-deduction mechanic: how it works step by step, and why it matters for a","description":"Full explanation of one elimination-deduction mechanic: how it works step by step, and why it matters for a\n    designer. Covers suggestion/disprove, process of elimination, accusations, notesheet tracking, movement,\n    card-counting, bluffing, and more. Use for \"how does disproving a suggestion work\", \"what is process of\n    elimination in these games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A mechanic's name or alias.","examples":["suggestion","process of elimination","notesheet","accusation"],"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/design_your_own":{"post":{"operationId":"design_your_own","summary":"Computes concrete setup guidance for a custom deduction game with the given number of categories and items","description":"Computes concrete setup guidance for a custom deduction game with the given number of categories and items\n    per category: total/solution/dealt card counts, deal sizes for common player counts, a qualitative difficulty\n    estimate, step-by-step build instructions, and any warnings if the numbers are unusually small or large. Use\n    for \"help me design my own deduction game with 4 categories of 6 items each\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_count":{"description":"How many categories the custom game will have.","examples":[3,4],"maximum":8,"minimum":2,"title":"Category Count","type":"integer"},"item_count":{"description":"How many items each category will contain.","examples":[6,8],"maximum":20,"minimum":2,"title":"Item Count","type":"integer"}},"required":["category_count","item_count"],"title":"design_your_ownArguments","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 elimination-deduction and logic-grid-puzzle vocabulary — suggestion, accusation, solution","description":"Definitions of elimination-deduction and logic-grid-puzzle vocabulary — suggestion, accusation, solution\n    set, disprove, notesheet, cross off, red herring, direct/negative/conditional/comparative clue, and more. Use\n    for \"what does disprove mean\", \"what's a negative clue\".","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/logic_grid_puzzle_howto":{"post":{"operationId":"logic_grid_puzzle_howto","summary":"Explains what a logic-grid puzzle is, how to solve one step by step, the four common clue types (direct,","description":"Explains what a logic-grid puzzle is, how to solve one step by step, the four common clue types (direct,\n    negative, conditional, comparative) with examples, a fully worked 3x3 example solved from clues to answer, and\n    tips for designing your own logic-grid puzzle with a guaranteed unique solution. Use for \"how do I solve a\n    logic grid puzzle\", \"how do I write my own logic puzzle clues\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"logic_grid_puzzle_howtoArguments","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/difficulty_tuning_tip":{"post":{"operationId":"difficulty_tuning_tip","summary":"How one specific design lever changes difficulty — category count, item count, hand size, red herrings,","description":"How one specific design lever changes difficulty — category count, item count, hand size, red herrings,\n    time limits, disprove visibility, notesheet complexity, solution uniqueness, or clue wording — with which\n    direction makes the game easier vs harder. Use for \"how do red herrings affect difficulty\", \"how many\n    categories should a hard deduction game use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"A design lever to tune.","examples":["category_count","item_count","hand_size","red_herrings","time_limit"],"minLength":1,"title":"Topic","type":"string"}},"required":["topic"],"title":"difficulty_tuning_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":"Suggests a suitable elimination-deduction format for a given player count, from a solo logic-grid puzzle","description":"Suggests a suitable elimination-deduction format for a given player count, from a solo logic-grid puzzle\n    through the classic 4-6 player sweet spot to party-scale team variants, with specific adjustments for that\n    group size. Use for \"what deduction game format works for 8 players\", \"can this genre work solo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many people will play.","examples":[1,5,10],"maximum":30,"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":"Ten abstract category archetypes you can mix and match to build your own elimination-deduction game — a","description":"Ten abstract category archetypes you can mix and match to build your own elimination-deduction game — a\n    culprit/suspect role, a method, a location, a motive, a time window, and more — each with a short description\n    and invented example items. None of these are drawn from any specific trademarked game's actual card set. Use\n    for \"what categories should my mystery game use\", \"give me ideas beyond suspects, weapons and rooms\".","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}},"/v1/tools/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"An ordered shortlist of practical tips for playing (and designing) elimination-deduction games well — what","description":"An ordered shortlist of practical tips for playing (and designing) elimination-deduction games well — what\n    to track, when to accuse, how to read logic-grid clues. Use for \"what should a beginner know about these\n    games\", \"tips for solving a whodunit puzzle faster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":14,"minimum":1,"title":"Count","type":"integer"}},"title":"beginner_tipsArguments","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}}}}