{"openapi":"3.1.0","info":{"title":"Chinesecheckers API","version":"0.1.0","description":"A fully local, hand-curated cross-and-circle / peg-jumping race-game reference centered on Chinese Checkers (Sternhalma): board geometry and jump-chain rules, player-count setups, strategy concepts, a glossary, board-geometry relatives (Halma, Ludo, Pachisi, Parcheesi and kin), beginner tips, an origin note and how games get scored.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://chinesecheckers.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/chinesecheckers/docs"},"termsOfService":"https://connectorbay.com/chinesecheckers/terms"},"servers":[{"url":"https://chinesecheckers.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/chinesecheckers/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":"Full detail for one rule topic: board layout, movement, jumping, chain jumps, home/target triangles,","description":"Full detail for one rule topic: board layout, movement, jumping, chain jumps, home/target triangles,\n    passing through other areas, turn order, illegal moves, or common house rules. Omit topic to list every\n    topic with its summary. Use for \"how does jumping work\", \"what happens when a marble reaches the target\n    triangle\", \"what counts as an illegal move\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A rule topic to look up; omit to list every topic.","examples":["jumping","chain jumps","home triangle","board layout","turn order"],"title":"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 Chinese Checkers and cross-and-circle board-game terms — Sternhalma, hexagram board, home","description":"Definitions of Chinese Checkers and cross-and-circle board-game terms — Sternhalma, hexagram board, home\n    and target triangle, simple step, jump/hop, chain jump, bridge marble, blocking, center field,\n    cross-and-circle game, track race game, adjacent hole, placings. Use for \"what's a bridge marble\", \"what\n    does hexagram board mean\".","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.","examples":["bridge marble","hop chain","hexagram board","cross-and-circle game"],"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/variant_info":{"post":{"operationId":"variant_info","summary":"Describes a named board-geometry relative of Chinese Checkers and how it relates: Sternhalma / standard","description":"Describes a named board-geometry relative of Chinese Checkers and how it relates: Sternhalma / standard\n    Chinese Checkers itself, Halma (its square-board ancestor), the two-player long game, super/big-board\n    editions, and the separate cross-and-circle family — Pachisi, Ludo, Parcheesi, Sorry!, Aggravation, Mensch\n    ärgere Dich nicht. Omit name to list every entry with its relation. Use for \"is Chinese Checkers related to\n    Ludo\", \"what's Halma\", \"what's the two-player long game\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A named variant or board-geometry relative; omit to list them all.","examples":["Halma","Pachisi","Ludo","Sorry!","Aggravation","two-player long game"],"title":"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/strategy_concept":{"post":{"operationId":"strategy_concept","summary":"Explains a named Chinese Checkers strategy concept — scanning for chains, leaving bridge marbles, building","description":"Explains a named Chinese Checkers strategy concept — scanning for chains, leaving bridge marbles, building\n    a hop ladder, avoiding lone-marble crawls, keeping target-triangle entry lanes open, center-field control,\n    reading opponents' bridges, endgame turn-counting, keeping a flexible marble, when (and when not) to block,\n    and the limits of mirroring in a 2-player opening. Omit name to list them all. Use for \"how do I play Chinese\n    Checkers well\", \"what's a bridge marble strategy\", \"should I block my opponent\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A named strategy concept; omit to list them all.","examples":["bridge marbles","hop ladder","center field control","endgame turn counting"],"title":"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/player_count_setup":{"post":{"operationId":"player_count_setup","summary":"The home/target triangle layout for a specific player count on the standard board: 1 (solo practice), 2,","description":"The home/target triangle layout for a specific player count on the standard board: 1 (solo practice), 2,\n    3, 4 (less standardized — printed rule sets genuinely differ here), or 6. Use for \"how do you set up a\n    3-player game\", \"how does 4-player Chinese Checkers work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"description":"Number of players.","examples":[2,3,4,6],"maximum":6,"minimum":1,"title":"Count","type":"integer"}},"required":["count"],"title":"player_count_setupArguments","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, ranked shortlist of the most useful tips for a player new to Chinese Checkers, from most to","description":"A curated, ranked shortlist of the most useful tips for a player new to Chinese Checkers, from most to\n    least essential. Use for \"tips for a beginner\", \"how do I get better at Chinese Checkers\".","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}},"/v1/tools/history_note":{"post":{"operationId":"history_note","summary":"The game's real origin: created in Germany as Sternhalma in the early 1890s from the earlier American game","description":"The game's real origin: created in Germany as Sternhalma in the early 1890s from the earlier American game\n    Halma, and only renamed 'Chinese Checkers' when it reached the US market in the late 1920s — a marketing\n    name with no real link to China, for a game that also has little in common with checkers/draughts. Use for\n    \"is Chinese Checkers actually Chinese\", \"where does Chinese Checkers come from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"history_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/scoring_summary":{"post":{"operationId":"scoring_summary","summary":"How winning and finishing order work: there's no move-by-move score, only who fills their target triangle","description":"How winning and finishing order work: there's no move-by-move score, only who fills their target triangle\n    first (and, if play continues, who does it next, and next after that). Use for \"how is Chinese Checkers\n    scored\", \"what happens after someone wins\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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}}}}