{"openapi":"3.1.0","info":{"title":"Bingo API","version":"0.1.0","description":"A fully local, hand-curated numbers-calling game reference: 75-ball (US) and 90-ball (UK) Bingo, 80-ball Bingo, Housie/Tambola as played in India, and Keno, with real card/ticket structure math, named winning patterns, traditional calling terminology, a format comparison tool, hosting tips and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bingo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bingo/docs"},"termsOfService":"https://connectorbay.com/bingo/terms"},"servers":[{"url":"https://bingo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bingo/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/format_list":{"post":{"operationId":"format_list","summary":"Every numbers-calling format covered by this reference, with region, ball pool size and card/ticket","description":"Every numbers-calling format covered by this reference, with region, ball pool size and card/ticket\n    shape. Use for \"what bingo formats do you cover\", \"what's the difference between US and UK bingo at a\n    glance\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"format_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/format_info":{"post":{"operationId":"format_info","summary":"Full overview of one numbers-calling format: region, ball pool, card/ticket shape, typical setting and","description":"Full overview of one numbers-calling format: region, ball pool, card/ticket shape, typical setting and\n    a plain-language summary of how it's played. Use for \"what is 90-ball bingo\", \"tell me about Tambola\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A format's name or alias.","examples":["75-ball bingo","UK bingo","Housie","Tambola","Keno"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"format_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/card_structure":{"post":{"operationId":"card_structure","summary":"The real structural math behind one format's card or ticket: column number ranges, free space","description":"The real structural math behind one format's card or ticket: column number ranges, free space\n    placement, numbers per card, and total ball pool size. Use for \"how many numbers are on a 75-ball bingo\n    card\", \"what number range is column 3 on a 90-ball ticket\", \"how does a keno ticket work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A format's name or alias.","examples":["75-ball bingo","90-ball bingo","80-ball bingo","Housie","Keno"],"minLength":1,"title":"Format","type":"string"}},"required":["format"],"title":"card_structureArguments","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/winning_pattern":{"post":{"operationId":"winning_pattern","summary":"Named winning patterns for a format — a specific pattern's full description (shape, which squares","description":"Named winning patterns for a format — a specific pattern's full description (shape, which squares\n    count), or every pattern the format uses when pattern_name is omitted. Use for \"what is a postage stamp\n    in bingo\", \"what's an Early Five in Tambola\", \"what winning patterns does 90-ball bingo use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A format's name or alias.","examples":["75-ball bingo","Housie","90-ball bingo"],"minLength":1,"title":"Format","type":"string"},"pattern_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific pattern's name; omit to list every pattern for the format.","examples":["Four Corners","Full House","Early Five","Postage Stamp"],"title":"Pattern Name"}},"required":["format"],"title":"winning_patternArguments","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/calling_terminology":{"post":{"operationId":"calling_terminology","summary":"The traditional bingo call for a specific number in a specific format (like \"Two Little Ducks\" for 22","description":"The traditional bingo call for a specific number in a specific format (like \"Two Little Ducks\" for 22\n    in 90-ball Bingo), described factually as folk terminology. For formats without a nickname tradition\n    (75-ball, 80-ball, Keno) this explains the real calling convention used instead. Use for \"what does two\n    little ducks mean\", \"what's the call for 88 in bingo\", \"does US bingo have number nicknames\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A format's name or alias.","examples":["90-ball bingo","Housie","75-ball bingo"],"minLength":1,"title":"Format","type":"string"},"number":{"description":"The number to look up the traditional call for.","examples":[22,88,1,45],"maximum":90,"minimum":1,"title":"Number","type":"integer"}},"required":["format","number"],"title":"calling_terminologyArguments","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 bingo/lottery-game terms — dauber, coverall, free space, strip, king number,","description":"Definitions of common bingo/lottery-game terms — dauber, coverall, free space, strip, king number,\n    Early Five, way ticket, kitty party, blind number, and more. Use for \"what's a dauber\", \"what does\n    coverall mean\", \"what's a king number in keno\".","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":"A side-by-side comparison of two formats' region, ball pool, card/ticket shape, numbers per card, free","description":"A side-by-side comparison of two formats' region, ball pool, card/ticket shape, numbers per card, free\n    space and typical setting. Use for \"90-ball vs 75-ball bingo, what's the difference\", \"compare Housie and\n    UK bingo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format_a":{"description":"First format's name or alias.","examples":["75-ball bingo"],"minLength":1,"title":"Format A","type":"string"},"format_b":{"description":"Second format's name or alias.","examples":["90-ball bingo"],"minLength":1,"title":"Format B","type":"string"}},"required":["format_a","format_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/host_a_game_tips":{"post":{"operationId":"host_a_game_tips","summary":"Practical tips for hosting a bingo, 90-ball, 80-ball or Housie/Tambola session — pacing calls,","description":"Practical tips for hosting a bingo, 90-ball, 80-ball or Housie/Tambola session — pacing calls,\n    verifying wins, keeping equipment ready, and a responsible-play note for real-money sessions. Use for\n    \"how do I run a bingo night\", \"tips for hosting Tambola at Diwali\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"host_a_game_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":"A format's real, broadly-verified origin story — phrased qualitatively wherever the historical record","description":"A format's real, broadly-verified origin story — phrased qualitatively wherever the historical record\n    is uncertain or partly legendary (as with Keno's Great Wall folklore). Use for \"where does bingo come\n    from\", \"is it true keno funded the Great Wall of China\", \"history of Housie in India\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"A format's name or alias.","examples":["75-ball bingo","Keno","Housie"],"minLength":1,"title":"Format","type":"string"}},"required":["format"],"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}}}}