{"openapi":"3.1.0","info":{"title":"Draught API","version":"0.1.0","description":"A fully local, hand-curated checkers/draughts rules and variant reference: rule mechanics (forced capture, the maximum-capture rule, kinging, flying kings, huffing, and more), major regional variants (English/American Checkers, International Draughts, Russian Draughts, Turkish Draughts, Canadian Checkers, and others) with a side-by-side comparison tool, board/move notation systems, strategy concepts, beginner tips, and a term glossary. Keyless; zero upstream API calls; nothing stored.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://draught.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/draught/docs"},"termsOfService":"https://connectorbay.com/draught/terms"},"servers":[{"url":"https://draught.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/draught/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 checkers/draughts rule or mechanic in full: forced capture, the maximum-capture rule,","description":"Explains one checkers/draughts rule or mechanic in full: forced capture, the maximum-capture rule,\n    multi-jump chains, kinging/crowning, short vs flying kings, backward capture by men, huffing, draw\n    conditions, opening restriction, and more, including how it varies (or doesn't) between variants. Use\n    for \"what is forced capture\", \"how does kinging work\", \"what's a flying king\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"description":"A checkers/draughts rule or mechanic to look up.","examples":["forced capture","kinging","flying kings","huffing","maximum capture rule"],"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/variant_info":{"post":{"operationId":"variant_info","summary":"Full detail on one named regional checkers/draughts variant: board size, pieces per side, whether","description":"Full detail on one named regional checkers/draughts variant: board size, pieces per side, whether\n    men can capture backward, king movement style (short or flying), whether a maximum-capture rule\n    applies, notation system, region/governing body, and what makes it distinctive. Use for \"what is\n    International Draughts\", \"how does Turkish Draughts work\", \"tell me about Russian Draughts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A checkers/draughts variant to explain.","examples":["English/American Checkers","International Draughts","Russian Draughts","Turkish Draughts","Canadian Checkers"],"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/variant_comparison":{"post":{"operationId":"variant_comparison","summary":"Lines up two named checkers/draughts variants side by side — board size, pieces per side, backward","description":"Lines up two named checkers/draughts variants side by side — board size, pieces per side, backward\n    capture for men, king movement, mandatory/maximum capture rules, notation, and region — and highlights\n    exactly which fields differ between them. Use for \"compare American checkers and International\n    Draughts\", \"how is Russian Draughts different from Turkish Draughts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"a":{"description":"The first variant to compare.","examples":["English/American Checkers"],"minLength":1,"title":"A","type":"string"},"b":{"description":"The second variant to compare.","examples":["International Draughts"],"minLength":1,"title":"B","type":"string"}},"required":["a","b"],"title":"variant_comparisonArguments","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 checkers/draughts term — man, king, crowning, flying king, shot, bridge, double corner,","description":"Defines a checkers/draughts term — man, king, crowning, flying king, shot, bridge, double corner,\n    tempo, phalanx, PDN, and more — or lists every term in the glossary when none is given. Use for \"what's\n    a shot in checkers\", \"what does 'double corner' mean\", \"list checkers 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/board_notation":{"post":{"operationId":"board_notation","summary":"Explains one board/move notation system used to record checkers/draughts games: how squares are","description":"Explains one board/move notation system used to record checkers/draughts games: how squares are\n    labeled, how quiet moves and captures are written, an example move, and which variants use it. Use for\n    \"how does draughts notation work\", \"what does 32-28 mean in checkers\", \"how are Turkish dama moves\n    written\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system":{"description":"A board/move notation system to explain.","examples":["international numeric","English numeric","chess-style algebraic","Turkish full-board"],"minLength":1,"title":"System","type":"string"}},"required":["system"],"title":"board_notationArguments","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/notation_reference":{"post":{"operationId":"notation_reference","summary":"Lists every board/move notation system covered — international numeric, English/American numeric,","description":"Lists every board/move notation system covered — international numeric, English/American numeric,\n    chess-style algebraic, and Turkish full-board — each with a short description and which variants use\n    it. Use for \"what notation systems does checkers use\", \"list draughts notation styles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"notation_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 checkers/draughts strategic idea — control of the center, the double corner, tempo,","description":"Explains a named checkers/draughts strategic idea — control of the center, the double corner, tempo,\n    the bridge, sacrifice for breakthrough, trading down when ahead, king mobility vs man count, edge play,\n    or phalanx formations — including which variants it's most relevant to. Use for \"what's the bridge in\n    checkers\", \"why trade pieces when I'm ahead\", \"what's a shot combination\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A strategic idea to explain.","examples":["control of the center","the bridge","tempo","sacrifice for breakthrough","trading down"],"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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated, ordered shortlist of tips for a new checkers/draughts player, from most to least","description":"A curated, ordered shortlist of tips for a new checkers/draughts player, from most to least\n    essential. Use for \"what should a checkers beginner focus on\", \"give me some draughts tips\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":12,"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}}}}