{"openapi":"3.1.0","info":{"title":"Diceroll API","version":"0.1.0","description":"A fully local, hand-curated dice-game reference: original rule summaries for 10 real dice games (Farkle, Bunco, Liar's Dice, Yacht, a rules-only social Craps variant, Ship-Captain-Crew, Pig, a Tenzi-style speed game, an LCR-style chip game, and Cee-lo), with real scoring calculators, real dice-probability math, a glossary, and group-size/duration recommendations.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://diceroll.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/diceroll/docs"},"termsOfService":"https://connectorbay.com/diceroll/terms"},"servers":[{"url":"https://diceroll.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/diceroll/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/game_rules":{"post":{"operationId":"game_rules","summary":"Full detail for one dice game: category, player count, duration, equipment, setup, numbered step-by-step","description":"Full detail for one dice game: category, player count, duration, equipment, setup, numbered step-by-step\n    play, scoring notes, winning condition, and known variants. Use for \"how do I play Farkle\", \"what are the\n    rules of Ship Captain Crew\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A dice game's name or alias.","examples":["Farkle","Bunco","Liar's Dice","Yacht","Craps","Ship Captain Crew","Pig","Cee-lo"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"game_rulesArguments","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/scoring_summary":{"post":{"operationId":"scoring_summary","summary":"Computes a REAL score, not a lookup, when dice are given for a game with calculable scoring: every","description":"Computes a REAL score, not a lookup, when dice are given for a game with calculable scoring: every\n    Yacht/Yahtzee-family category (or one named category) for 5 dice, a full Farkle roll's breakdown, a Cee-lo\n    roll's outcome, a Bunco roll's points against a round target, a Ship-Captain-Crew cargo total, or a Pig\n    turn's running total and bust status. Without dice, returns the game's textual scoring/winning rules instead\n    (used for Liar's Dice and Roll & Pass, which have no numeric score). Use for \"score this Yacht roll: 3 3 3 5\n    5\", \"what's the Farkle value of 1 1 1 5 2 6\", \"is 4 4 2 a good Cee-lo roll\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A dice game's name or alias.","examples":["Yacht","Farkle","Cee-lo","Bunco","Ship Captain Crew","Pig"],"minLength":1,"title":"Name","type":"string"},"dice":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"default":null,"description":"Dice values (1-6) to score. Yacht needs 5, Cee-lo and Bunco need 3, Ship-Captain-Crew needs 5, Farkle takes 1-6, Pig takes a sequence of single-die rolls for one turn. Omit to get the game's textual scoring rules instead of a computed score.","examples":[[3,3,3,5,5],[1,1,5,2,4]],"title":"Dice"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"For Yacht only: a specific category (ones, twos, threes, fours, fives, sixes, three_of_a_kind, four_of_a_kind, full_house, small_straight, large_straight, yacht, chance). Omit to get every category's score for the given dice.","title":"Category"},"target":{"anyOf":[{"maximum":6,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"For Bunco only: the current round's target number (1-6).","title":"Target"}},"required":["name"],"title":"scoring_summaryArguments","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 dice-game terms — bust, hot dice, push your luck, point, natural, snake eyes,","description":"Definitions of common dice-game terms — bust, hot dice, push your luck, point, natural, snake eyes,\n    boxcars, cargo, wild, bid/raise, house rule, and more. Use for \"what does hot dice mean\", \"what's a natural\n    in Craps\".","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/games_by_player_count":{"post":{"operationId":"games_by_player_count","summary":"Every dice game in this reference that fits a given number of players. Use for \"what dice games work for","description":"Every dice game in this reference that fits a given number of players. Use for \"what dice games work for\n    5 people\", \"dice games for just two of us\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"description":"Number of players.","maximum":30,"minimum":1,"title":"Count","type":"integer"}},"required":["count"],"title":"games_by_player_countArguments","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/probability_note":{"post":{"operationId":"probability_note","summary":"Real combinatorial probability for a simple single-die or two-dice outcome — exact fraction, decimal,","description":"Real combinatorial probability for a simple single-die or two-dice outcome — exact fraction, decimal,\n    percent, and a short note tying it to the named game when relevant (e.g. a Pig bust chance, a Craps natural).\n    Use for \"odds of rolling a 7 with two dice\", \"chance of snake eyes\", \"how likely is a bust in Pig\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"A dice game name, for context in the answer.","examples":["Craps","Pig","Farkle"],"minLength":1,"title":"Game","type":"string"},"dice_count":{"description":"1 for a single die, 2 for two dice rolled together.","maximum":2,"minimum":1,"title":"Dice Count","type":"integer"},"outcome":{"description":"The outcome to compute odds for. One die: a face value 1-6, or 'even'/'odd'. Two dice: a total 2-12, 'double', 'even'/'odd', 'snake eyes', 'boxcars', 'natural' (7 or 11), or 'craps' (2, 3, or 12).","examples":["6","7","snake eyes","double","natural"],"minLength":1,"title":"Outcome","type":"string"}},"required":["game","dice_count","outcome"],"title":"probability_noteArguments","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 dice games that fit a player count and, optionally, a rough duration, with games whose *ideal*","description":"Suggests dice games that fit a player count and, optionally, a rough duration, with games whose *ideal*\n    player range matches listed first. Use for \"what dice game works for 8 people in under 20 minutes\", \"quick\n    dice game for 3 players\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"Number of players.","maximum":30,"minimum":1,"title":"Player Count","type":"integer"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"short (<20 min), medium (20-45 min), or long (45+ min); omit for any length.","title":"Duration"}},"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 dice-game category covered (Push Your Luck, Category Scoring, Bluffing & Deduction, Casino-Style","description":"Every dice-game category covered (Push Your Luck, Category Scoring, Bluffing & Deduction, Casino-Style\n    Social, Party & Pure Luck, Pub & Folk, Speed & Reflex) with how many games are in each. Use for \"what kinds\n    of dice games do you cover\".","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":"A curated shortlist of tips for learning a specific dice game. Use for \"any tips for playing Farkle\",","description":"A curated shortlist of tips for learning a specific dice game. Use for \"any tips for playing Farkle\",\n    \"how do I get better at Pig\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A dice game's name or alias.","minLength":1,"title":"Name","type":"string"}},"required":["name"],"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}}}}