{"openapi":"3.1.0","info":{"title":"Domino API","version":"0.1.0","description":"A fully local, hand-curated dominoes reference: rules and how-to-play for 10 variants (Block, Draw, Mexican Train, Muggins/All Fives, Chicken Foot, Cuban Dominoes, Bergen, Matador, Texas 42, Fives and Threes), each variant's own scoring method, a term glossary, tileset explainers (double-6/9/12/15), player-count based game recommendations, category browsing, and beginner tips.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://domino.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/domino/docs"},"termsOfService":"https://connectorbay.com/domino/terms"},"servers":[{"url":"https://domino.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/domino/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 rules for one domino variant: category, player count, tile set used, objective, setup steps, and a","description":"Full rules for one domino variant: category, player count, tile set used, objective, setup steps, and a\n    numbered how-to-play sequence. Use for \"how do I play Mexican Train\", \"what's the objective in Cuban\n    Dominoes\", \"how do you set up Bergen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A domino variant's name or alias.","examples":["Block","Mexican Train","Muggins","Chicken Foot","Texas 42"],"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":"How one domino variant is scored: the method, when points are awarded, a typical target score, and a","description":"How one domino variant is scored: the method, when points are awarded, a typical target score, and a\n    worked example. Use for \"how is Muggins scored\", \"what's a Mexican Train hand worth\", \"how many points do\n    you need to win at Texas 42\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A domino variant's name or alias.","examples":["Muggins","Mexican Train","Texas 42","Bergen"],"minLength":1,"title":"Name","type":"string"}},"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/games_by_player_count":{"post":{"operationId":"games_by_player_count","summary":"Every domino variant whose supported player-count range includes the given number of players. Use for","description":"Every domino variant whose supported player-count range includes the given number of players. Use for\n    \"what dominoes games work with 3 players\", \"which variants support 8 people\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"description":"Number of players.","maximum":20,"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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Defines a dominoes term — pip, boneyard, spinner, chicken foot, train, station marker, count domino,","description":"Defines a dominoes term — pip, boneyard, spinner, chicken foot, train, station marker, count domino,\n    and more — or lists every term in the glossary when none is given. Use for \"what's a boneyard\", \"what\n    does 'chicken foot' mean\", \"list dominoes 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/tileset_info":{"post":{"operationId":"tileset_info","summary":"Explains a standard physical domino tile set — double-6, double-9, double-12, or double-15 — including","description":"Explains a standard physical domino tile set — double-6, double-9, double-12, or double-15 — including\n    tile count, pip range, typical player counts, and which variants commonly use it; lists all four when no\n    set name is given. Use for \"what's in a double-12 set\", \"how many tiles are in a double-9 set\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A tile set name; omit to list all four.","examples":["double-6","double-9","double-12","double-15"],"title":"Name"}},"title":"tileset_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_game_for_group":{"post":{"operationId":"find_game_for_group","summary":"Recommends domino variants for a group of a given size, with the closest-fit variants ranked first","description":"Recommends domino variants for a group of a given size, with the closest-fit variants ranked first\n    rather than just every variant that technically supports that many players. Use for \"what dominoes game\n    should we play with 6 people\", \"best domino variant for 2 players\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"Number of players in the group.","maximum":20,"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 domino variant category (Blocking, Scoring, Hub & Layout, Partnership, Matching & Sum,","description":"Every domino variant category (Blocking, Scoring, Hub & Layout, Partnership, Matching & Sum,\n    Trick-Taking) with how many variants are in each. Use for \"what kinds of dominoes 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, ordered shortlist of tips for a new dominoes player, from most to least essential. Use for","description":"A curated, ordered shortlist of tips for a new dominoes player, from most to least essential. Use for\n    \"what should a dominoes beginner focus on\", \"give me some tips for playing dominoes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":10,"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}}}}