{"openapi":"3.1.0","info":{"title":"Holdem API","version":"0.1.0","description":"A fully local, hand-curated poker variant RULES reference: how Texas Hold'em, Omaha, Omaha Hi-Lo, Seven-Card Stud, Five-Card Draw, Razz and Short Deck Hold'em are each dealt and played, hand composition and ranking systems (standard high, ace-to-five low, the eight-or-better hi-lo qualifier, and short-deck ranking), betting-round structure, a shared glossary, side-by-side variant comparison, a feature finder, and history notes. Rules only — never betting odds, EV/strategy, or bankroll advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://holdem.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/holdem/docs"},"termsOfService":"https://connectorbay.com/holdem/terms"},"servers":[{"url":"https://holdem.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/holdem/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/variant_rules":{"post":{"operationId":"variant_rules","summary":"Full detail for one poker variant: family, deck, typical player count, how many hole cards each","description":"Full detail for one poker variant: family, deck, typical player count, how many hole cards each\n    player gets and how many community cards (if any), the exact hand-composition rule, which\n    hand-ranking system(s) it uses, forced bets, and any special rules unique to it. Use for \"how do you\n    play Omaha\", \"what are the rules of Razz\", \"how is Short Deck Hold'em different\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A poker variant's name or alias.","examples":["Texas Hold'em","Omaha","Omaha Hi-Lo","Seven-Card Stud","Five-Card Draw","Razz","Short Deck Hold'em"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"variant_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/deal_procedure":{"post":{"operationId":"deal_procedure","summary":"The exact ordered dealing procedure for one variant — forced bets, the order cards are dealt","description":"The exact ordered dealing procedure for one variant — forced bets, the order cards are dealt\n    face-down versus face-up, where each betting round falls, and how showdown works — from the first\n    forced bet through showdown. Use for \"walk me through how a hand of Hold'em is dealt\", \"what's the\n    exact order of play in Seven-Card Stud\", \"how does the draw work in Five-Card Draw\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A poker variant's name or alias.","examples":["Texas Hold'em","Seven-Card Stud","Five-Card Draw"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"deal_procedureArguments","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/betting_round_explainer":{"post":{"operationId":"betting_round_explainer","summary":"Names and explains just the betting-round structure for one variant, generically: pre-flop/flop/","description":"Names and explains just the betting-round structure for one variant, generically: pre-flop/flop/\n    turn/river in community-card games, third-through-seventh street in Stud/Razz (and how the opening\n    action is decided each street), or pre-draw/the draw/post-draw in Five-Card Draw. No strategy —\n    structure only. Use for \"what are the betting rounds in Hold'em called\", \"how many streets does Stud\n    have\", \"what happens between the two betting rounds in Five-Card Draw\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A poker variant's name or alias.","examples":["Texas Hold'em","Omaha Hi-Lo","Razz"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"betting_round_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/hand_ranking_reference":{"post":{"operationId":"hand_ranking_reference","summary":"Explains one of the four hand-ranking systems used across these variants — the standard high","description":"Explains one of the four hand-ranking systems used across these variants — the standard high\n    ranking (royal flush down to high card), ace-to-five low (used in Razz: aces low, straights/flushes\n    ignored, pairs are bad), the eight-or-better low qualifier (used in Omaha Hi-Lo), or the short-deck\n    high ranking (flush above full house) — or lists all four with which variants use each when no system\n    is named. Use for \"what beats what in poker\", \"how does ace-to-five low ranking work\", \"what's the\n    eight-or-better qualifier\", \"why does a flush beat a full house in short deck\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A hand-ranking system's name; omit to list all four.","examples":["standard high","ace-to-five low","eight or better","short deck"],"title":"System"}},"title":"hand_ranking_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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of common poker terms shared across these variants — blind, ante, bring-in, up card,","description":"Definitions of common poker terms shared across these variants — blind, ante, bring-in, up card,\n    the nuts, kicker, wheel, broadway, hi-lo split, qualifier, scoop, quartered, stand pat, rake, and more\n    — or lists every term in the glossary when none is given. Use for \"what's a bring-in\", \"what does\n    'quartered' mean\", \"what's the difference between a scoop and being quartered\".","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/variant_comparison":{"post":{"operationId":"variant_comparison","summary":"Lines up two named poker variants side by side — family, deck, player count, hole/community cards,","description":"Lines up two named poker variants side by side — family, deck, player count, hole/community cards,\n    hand-composition rule, hand-ranking system(s), and forced-bet structure — and highlights exactly which\n    fields differ between them. Use for \"compare Texas Hold'em and Omaha\", \"how is Razz different from\n    Seven-Card Stud\", \"what's different between Omaha and Omaha Hi-Lo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"a":{"description":"The first variant to compare.","examples":["Texas Hold'em"],"minLength":1,"title":"A","type":"string"},"b":{"description":"The second variant to compare.","examples":["Omaha"],"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/find_variant_by_feature":{"post":{"operationId":"find_variant_by_feature","summary":"Finds variants matching a stated structural feature — hi-lo split, shared community cards, no","description":"Finds variants matching a stated structural feature — hi-lo split, shared community cards, no\n    community cards, a draw/discard mechanic, a short deck, a bring-in, antes versus blinds, and more.\n    Use for \"which variants have a hi-lo split\", \"what poker games don't use community cards\", \"which\n    variant uses a 36-card deck\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"feature":{"description":"A structural feature to search for.","examples":["hi-lo split","shared community cards","no community cards","short deck","draw/discard mechanic","bring-in"],"minLength":1,"title":"Feature","type":"string"}},"required":["feature"],"title":"find_variant_by_featureArguments","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":"A brief, qualitative note on one variant's origin and how it rose to its current place in poker,","description":"A brief, qualitative note on one variant's origin and how it rose to its current place in poker,\n    phrased carefully where the historical record is genuinely uncertain. Use for \"where did Texas Hold'em\n    come from\", \"how old is Seven-Card Stud\", \"when did Short Deck Hold'em become popular\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A poker variant's name or alias.","examples":["Texas Hold'em","Razz","Short Deck Hold'em"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"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/responsible_play_note":{"post":{"operationId":"responsible_play_note","summary":"This reference's play-responsibly note, on its own: a reminder that this is a rules reference, not","description":"This reference's play-responsibly note, on its own: a reminder that this is a rules reference, not\n    gambling advice, and that poker is most often played for real money. Use for \"is this gambling\n    advice\", \"give me a responsible-play disclaimer for poker\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"responsible_play_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}}}}