{"openapi":"3.1.0","info":{"title":"Lotería (Cards) API","version":"0.1.0","description":"A hand-curated, original reference for the traditional Mexican game of Lotería: all 54 traditional card names with folkloric meaning and symbolism, a genuine-random tabla generator, how-to-play rules, winning-pattern explainers, regional/house variants, deeper card folklore, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://loteria.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/loteria/docs"},"termsOfService":"https://connectorbay.com/loteria/terms"},"servers":[{"url":"https://loteria.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/loteria/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/card_info":{"post":{"operationId":"card_info","summary":"One traditional Lotería card's Spanish name, English gloss, deck number, folkloric meaning/symbolism,","description":"One traditional Lotería card's Spanish name, English gloss, deck number, folkloric meaning/symbolism,\n    and a general visual-motif description. Use for \"what does La Sirena mean\", \"tell me about El Diablito\",\n    \"what's card number 14 in Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional Lotería card's Spanish name (with or without El/La), English gloss, or deck number (1-54).","examples":["La Sirena","Sirena","mermaid","6"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"card_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_search":{"post":{"operationId":"card_search","summary":"Search all 54 traditional Lotería cards by keyword across their names, folkloric meaning, folklore","description":"Search all 54 traditional Lotería cards by keyword across their names, folkloric meaning, folklore\n    notes and tagged themes. Use for \"which Lotería cards are about birds\", \"find a card about luck\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across card names, meanings, folklore notes and keywords.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"card_searchArguments","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/deck_list":{"post":{"operationId":"deck_list","summary":"All 54 traditional Lotería card names with their deck numbers, in order. Use for \"list every Lotería","description":"All 54 traditional Lotería card names with their deck numbers, in order. Use for \"list every Lotería\n    card\", \"how many cards are in a Lotería deck\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"deck_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/how_to_play":{"post":{"operationId":"how_to_play","summary":"The full rules of Lotería: setup (tablas/boards and markers), how a round is played (the cantor","description":"The full rules of Lotería: setup (tablas/boards and markers), how a round is played (the cantor\n    calling cards, marking a match), and how a round ends. Use for \"how do you play Lotería\", \"explain the\n    rules of Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"how_to_playArguments","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_generator":{"post":{"operationId":"board_generator","summary":"Generate a genuinely random Lotería tabla (board) by sampling distinct cards from the 54-card deck","description":"Generate a genuinely random Lotería tabla (board) by sampling distinct cards from the 54-card deck\n    with real computed randomness -- never a fixed or cached layout, so no two calls return the same board.\n    'full' (default) gives the traditional 16-card 4x4 board; 'mini' gives a quick 4-card 2x2 board for a\n    fast round. Use for \"generate a random Lotería board\", \"give me a tabla for a game\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"default":"full","description":"'full' for a traditional 16-card (4x4) tabla, or 'mini' for a quick 4-card (2x2) tabla.","title":"Pattern","type":"string"}},"title":"board_generatorArguments","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_patterns":{"post":{"operationId":"winning_patterns","summary":"Explains each recognized Lotería winning pattern: línea (a line in any direction), cuatro esquinas","description":"Explains each recognized Lotería winning pattern: línea (a line in any direction), cuatro esquinas\n    (four corners), tabla llena (full board/blackout), and corrida (the whole deck called). Use for \"what's\n    a tabla llena in Lotería\", \"how do you win at Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"linea | four_corners | tabla_llena | corrida; omit to list all.","title":"Pattern"}},"title":"winning_patternsArguments","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/game_variants":{"post":{"operationId":"game_variants","summary":"Regional and house-rule variants of Lotería: full-board vs. first-line play, beans vs. tokens as","description":"Regional and house-rule variants of Lotería: full-board vs. first-line play, beans vs. tokens as\n    markers, calling styles, and more. Use for \"what are the different ways to play Lotería\", \"do people\n    use beans or chips in Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"game_variantsArguments","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_folklore":{"post":{"operationId":"card_folklore","summary":"A standalone, deeper look at one Lotería card's cultural and historical folklore -- fuller context","description":"A standalone, deeper look at one Lotería card's cultural and historical folklore -- fuller context\n    than card_info's short symbolic reading. Use for \"tell me the deeper folklore behind La Calavera\",\n    \"what's the cultural history of El Venado in Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional Lotería card's Spanish name (with or without El/La), English gloss, or deck number.","examples":["La Muerte","El Nopal","45"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"card_folkloreArguments","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/loteria_glossary":{"post":{"operationId":"loteria_glossary","summary":"A short glossary of core Lotería terms: tabla (board), frijol (bean marker), cantor (caller), grito","description":"A short glossary of core Lotería terms: tabla (board), frijol (bean marker), cantor (caller), grito\n    (the call/riddle), llena (full board), corrida (full deck run), and more. Use for \"what does cantor\n    mean in Lotería\", \"what's a frijol used for in Lotería\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"tabla | cantor | frijol | grito | linea | llena | corrida | baraja | buena; omit to list all.","title":"Term"}},"title":"loteria_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}}}}