{"openapi":"3.1.0","info":{"title":"Gammon API","version":"0.1.0","description":"A fully local, hand-curated backgammon reference: rules (bearing off, hitting, blots, the bar, priming), scoring (single game, gammon, backgammon, the doubling cube), a term glossary, standard opening-roll guidance for all 15 non-double dice rolls, strategy concepts (running, priming, back and holding games, blitz), variant rules (Acey-deucey, Hypergammon, Nackgammon), beginner tips and match-play basics. Rules and concepts only, never betting or odds advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://gammon.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/gammon/docs"},"termsOfService":"https://connectorbay.com/gammon/terms"},"servers":[{"url":"https://gammon.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/gammon/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/rule_lookup":{"post":{"operationId":"rule_lookup","summary":"Explains one backgammon rule or mechanic in full: bearing off, hitting, blots, the bar, blocked points,","description":"Explains one backgammon rule or mechanic in full: bearing off, hitting, blots, the bar, blocked points,\n    forced moves, the doubling cube, priming, anchors, pip count, and more. Use for \"how do I bear off\", \"what\n    happens when I get hit\", \"how does the doubling cube work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"A backgammon rule or mechanic to look up.","examples":["bearing off","hitting","the bar","blots","priming","doubling cube"],"minLength":1,"title":"Topic","type":"string"}},"required":["topic"],"title":"rule_lookupArguments","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_explainer":{"post":{"operationId":"scoring_explainer","summary":"Explains how a backgammon game is scored: a single game, a gammon (double value), a backgammon (triple","description":"Explains how a backgammon game is scored: a single game, a gammon (double value), a backgammon (triple\n    value), and how the doubling cube multiplies the stake. Use for \"what's a gammon worth\", \"how much is a\n    backgammon win\", \"how does the doubling cube change the score\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"concept":{"description":"A scoring concept to explain.","examples":["single game","gammon","backgammon","doubling cube"],"minLength":1,"title":"Concept","type":"string"}},"required":["concept"],"title":"scoring_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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Defines a backgammon term — blot, anchor, pip, prime, bar point, made point, Crawford rule, and more —","description":"Defines a backgammon term — blot, anchor, pip, prime, bar point, made point, Crawford rule, and more —\n    or lists every term in the glossary when none is given. Use for \"what's a blot\", \"what does 'pip count'\n    mean\", \"list backgammon terms\".","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/opening_move_reference":{"post":{"operationId":"opening_move_reference","summary":"The standard, commonly played response to one of the 15 possible non-double opening dice rolls (e.g.","description":"The standard, commonly played response to one of the 15 possible non-double opening dice rolls (e.g.\n    \"3-1\", \"6-5\"), described generically in plain point-to-point terms with the reasoning behind it. Use for\n    \"what's the best opening move for 3-1\", \"how should I play a 6-5 opening roll\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dice_roll":{"description":"An opening dice roll, e.g. '3-1' or '6-5'.","examples":["3-1","6-5","4-2","6-4"],"minLength":1,"title":"Dice Roll","type":"string"}},"required":["dice_roll"],"title":"opening_move_referenceArguments","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/strategy_concept":{"post":{"operationId":"strategy_concept","summary":"Explains a named backgammon strategic approach — running game, priming game, back game, holding game,","description":"Explains a named backgammon strategic approach — running game, priming game, back game, holding game,\n    blitz, or a prime-vs-prime battle — including when it's used and its main risk. Use for \"what's a back\n    game\", \"when should I play a holding game\", \"what's a backgammon blitz\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A strategic approach to explain.","examples":["running game","priming game","back game","holding game","blitz"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"strategy_conceptArguments","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/variant_info":{"post":{"operationId":"variant_info","summary":"Explains a named backgammon variant — Acey-deucey, Hypergammon, or Nackgammon — and how it differs from","description":"Explains a named backgammon variant — Acey-deucey, Hypergammon, or Nackgammon — and how it differs from\n    standard backgammon. Use for \"what's Acey-deucey\", \"how is Hypergammon different from regular backgammon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A backgammon variant to explain.","examples":["Acey-deucey","Hypergammon","Nackgammon"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"variant_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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated, ordered shortlist of tips for a new backgammon player, from most to least essential. Use for","description":"A curated, ordered shortlist of tips for a new backgammon player, from most to least essential. Use for\n    \"what should a beginner focus on\", \"give me some backgammon tips\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":16,"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}},"/v1/tools/match_play_basics":{"post":{"operationId":"match_play_basics","summary":"Explains match-play basics not present in a single money game: the Crawford rule, post-Crawford cube","description":"Explains match-play basics not present in a single money game: the Crawford rule, post-Crawford cube\n    strategy, how gammons are capped by what's needed to win the match, and how match score changes both cube\n    and checker-play decisions. Use for \"what's the Crawford rule\", \"how does match play differ from money\n    play\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"match_play_basicsArguments","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}}}}