{"openapi":"3.1.0","info":{"title":"Abstract API","version":"0.1.0","description":"A fully local, hand-curated abstract strategy games reference: Hex, Quoridor, Nine Men's Morris, and the Mancala family of sowing games across its many regional names (Kalah, Oware, Bao, Congkak, Sungka, Ayoayo, Wari, Omweso, Toguz Korgool, Pallanguzhi), each with origin, objective, setup, step-by-step rules, named rule topics, basic strategy concepts, and named regional/rule variants, plus a cross-game glossary and origin-by-region browsing.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://abstract.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/abstract/docs"},"termsOfService":"https://connectorbay.com/abstract/terms"},"servers":[{"url":"https://abstract.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/abstract/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_info":{"post":{"operationId":"game_info","summary":"Full detail for one game: category, player count, origin (region, period, historical note), equipment,","description":"Full detail for one game: category, player count, origin (region, period, historical note), equipment,\n    objective, setup, numbered how-to-play steps, and named key rule topics. Use for \"how do you play Hex\",\n    \"what's the setup for Bao\", \"how many players does Quoridor support\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Hex","Quoridor","Nine Men's Morris","Oware","Bao","Toguz Korgool"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"game_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/rule_lookup":{"post":{"operationId":"rule_lookup","summary":"Finds one named rule topic within a specific game, such as Oware's starvation rule, Nine Men's Morris's","description":"Finds one named rule topic within a specific game, such as Oware's starvation rule, Nine Men's Morris's\n    flying rule, or Bao's relay sowing. Use for \"what's the starvation rule in Oware\", \"how does capturing work\n    in Toguz Korgool\", \"when can you fly in Nine Men's Morris\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"A game's name or alias.","examples":["Oware","Nine Men's Morris","Bao"],"minLength":1,"title":"Game","type":"string"},"topic":{"description":"A rule topic to look up, in plain language.","examples":["starvation rule","flying rule","relay sowing","capture condition","wall legality"],"minLength":1,"title":"Topic","type":"string"}},"required":["game","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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of cross-game abstract-strategy and Mancala vocabulary -- sowing, relay sow, mill, bridge, pie","description":"Definitions of cross-game abstract-strategy and Mancala vocabulary -- sowing, relay sow, mill, bridge, pie\n    rule, starvation rule, zugzwang, combinatorial game, and more. Use for \"what does 'sowing' mean\", \"what's a\n    mill\", \"what's the pie rule\".","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_origin":{"post":{"operationId":"games_by_origin","summary":"Groups games by region of origin. The Mancala family in particular is played under many regional names","description":"Groups games by region of origin. The Mancala family in particular is played under many regional names\n    across Africa and Asia, so this is the tool for \"what Mancala games come from West Africa\" or \"what abstract\n    strategy games come from Europe\". Historical origin claims for older games are stated qualitatively where\n    genuinely disputed -- see each game's origin.note and, for Mancala variants, mancala_family_note.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A region, country, or continent to search for.","examples":["West Africa","Southeast Asia","Europe","Ghana","Central Asia"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"games_by_originArguments","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":"Looks up a named basic-strategy concept for one game, such as Hex's \"bridge\", Kalah's \"loading the","description":"Looks up a named basic-strategy concept for one game, such as Hex's \"bridge\", Kalah's \"loading the\n    store\", or Quoridor's \"wall economy\". Omit `name` to list every strategy concept recorded for that game. Use\n    for \"what's the bridge tactic in Hex\", \"how do you play well in Bao\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"A game's name or alias.","examples":["Hex","Kalah","Quoridor"],"minLength":1,"title":"Game","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific named concept to look up; omit to list every concept for the game.","examples":["bridge","loading the store","wall economy"],"title":"Name"}},"required":["game"],"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":"Looks up a named regional or rule variant of one game, such as Nine Men's Morris's \"Six Men's Morris\",","description":"Looks up a named regional or rule variant of one game, such as Nine Men's Morris's \"Six Men's Morris\",\n    Bao's beginner \"Bao la kujifunza\", or Quoridor's 4-player mode. Omit `name` to list every variant recorded\n    for that game. Use for \"what's Six Men's Morris\", \"is there a simpler version of Bao\", \"can four people play\n    Quoridor\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"A game's name or alias.","examples":["Nine Men's Morris","Bao","Oware"],"minLength":1,"title":"Game","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific named variant to look up; omit to list every variant recorded for the game.","examples":["Six Men's Morris","Bao la kujifunza","4-player Quoridor"],"title":"Name"}},"required":["game"],"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/find_game_for_group":{"post":{"operationId":"find_game_for_group","summary":"Suggests which games in this reference suit a given number of players. Most abstract strategy games,","description":"Suggests which games in this reference suit a given number of players. Most abstract strategy games,\n    including everything in the Mancala family here, are strictly two-player; Quoridor is the one exception,\n    officially supporting 2 or 4. This tool says so plainly rather than inventing multiplayer modes that don't\n    exist, and suggests round-robin/bracket formats for other group sizes. Use for \"what can four of us play\",\n    \"is there a 3-player version of any of these\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many people want to play.","examples":[1,2,3,4],"maximum":50,"minimum":0,"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 game category with how many games are in it (Connection games, Blocking & Racing games, Line & Mill","description":"Every game category with how many games are in it (Connection games, Blocking & Racing games, Line & Mill\n    games, Mancala / Sowing games). Use for \"what categories of 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}}}}