{"openapi":"3.1.0","info":{"title":"Lucha (Wrestling) API","version":"0.1.0","description":"A fully local Lucha Libre (Mexican professional wrestling) history and cultural reference: origins, mask tradition, técnico/rudo dynamics, move vocabulary, weight classes, match-type rules, legendary retired/deceased figures, and major promotion history.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://lucha.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/lucha/docs"},"termsOfService":"https://connectorbay.com/lucha/terms"},"servers":[{"url":"https://lucha.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/lucha/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/history_overview":{"post":{"operationId":"history_overview","summary":"The documented history of Lucha Libre: its late-19th-century origins, the 1933 founding of EMLL (today's","description":"The documented history of Lucha Libre: its late-19th-century origins, the 1933 founding of EMLL (today's\n    CMLL) that turned it into a lasting business, and its evolution into today's Lucha Libre. Use for \"how did\n    lucha libre start\", \"what's the history of lucha libre\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"history_overviewArguments","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/move_glossary":{"post":{"operationId":"move_glossary","summary":"Explanations of technical Spanish wrestling-move terminology used internationally in the sport -- quebradora,","description":"Explanations of technical Spanish wrestling-move terminology used internationally in the sport -- quebradora,\n    plancha, tope/tope suicida, huracanrana, tijera, castigada, llave -- what each move or term describes. Use for\n    \"what's a huracanrana\", \"what does tope suicida mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A move name, e.g. quebradora, plancha, tope, huracanrana, tijera, castigada, llave. Omit to list all.","title":"Term"}},"title":"move_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/mask_tradition_guide":{"post":{"operationId":"mask_tradition_guide","summary":"The cultural significance of the luchador mask, the lucha de apuestas (mask-vs-mask, mask-vs-hair) wager","description":"The cultural significance of the luchador mask, the lucha de apuestas (mask-vs-mask, mask-vs-hair) wager\n    tradition and its documented history, and the gravity of losing a mask match. Use for \"why do luchadores wear\n    masks\", \"what's a lucha de apuestas\", \"what happens when a luchador loses his mask\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"mask_tradition_guideArguments","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/role_explainer":{"post":{"operationId":"role_explainer","summary":"The técnico (hero/technical wrestler) vs rudo (villain/tough guy) dynamic that structures Lucha Libre, plus","description":"The técnico (hero/technical wrestler) vs rudo (villain/tough guy) dynamic that structures Lucha Libre, plus\n    the exótico character category, and their cultural role. Use for \"what's a técnico\", \"what's the difference\n    between a técnico and a rudo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"role":{"description":"tecnico | rudo | exotico (or face/hero, heel/villain).","examples":["tecnico","rudo","exotico"],"title":"Role","type":"string"}},"required":["role"],"title":"role_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/legendary_figures":{"post":{"operationId":"legendary_figures","summary":"Brief, factual, encyclopedia-style profiles of historically significant Lucha Libre figures, largely retired","description":"Brief, factual, encyclopedia-style profiles of historically significant Lucha Libre figures, largely retired\n    or deceased -- El Santo, Blue Demon, Mil Máscaras, Rayo de Jalisco Sr., Gory Guerrero, and Perro Aguayo --\n    covering birth/career dates and documented historical significance only, no fictional storyline content. Use\n    for \"tell me about El Santo\", \"who was Blue Demon\", \"list legendary luchadores\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A luchador's name, e.g. 'El Santo' or 'Blue Demon'; omit to list all.","title":"Name"}},"title":"legendary_figuresArguments","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/promotion_history":{"post":{"operationId":"promotion_history","summary":"Brief factual organizational history of Lucha Libre's major promotions -- CMLL (founded 1933 as EMLL) and","description":"Brief factual organizational history of Lucha Libre's major promotions -- CMLL (founded 1933 as EMLL) and\n    AAA (founded 1992) -- founding facts and milestones, not current rosters or storylines. Use for \"when was CMLL\n    founded\", \"who founded AAA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"cmll | aaa; omit to list both.","title":"Name"}},"title":"promotion_historyArguments","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/weight_classes":{"post":{"operationId":"weight_classes","summary":"Lucha Libre's traditional weight-class system, from Peso Completo (heavyweight, unlimited) down through the","description":"Lucha Libre's traditional weight-class system, from Peso Completo (heavyweight, unlimited) down through the\n    lighter divisions to Mini- and Micro-Estrella. Use for \"what are the lucha libre weight classes\", \"what's peso\n    pluma\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"weight_classesArguments","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/match_types":{"post":{"operationId":"match_types","summary":"Rules explanations for Lucha Libre's distinctive match formats -- lucha de apuestas (wager matches), torneo","description":"Rules explanations for Lucha Libre's distinctive match formats -- lucha de apuestas (wager matches), torneo\n    cibernético, trios, relevos australianos, and jaula (cage matches). Use for \"what's a torneo cibernético\",\n    \"how does a cage match work in lucha libre\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"lucha_de_apuestas | torneo_cibernetico | trios | relevos_australianos | jaula. Omit to list all.","title":"Type"}},"title":"match_typesArguments","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/lucha_glossary":{"post":{"operationId":"lucha_glossary","summary":"Definitions of roughly a dozen core Lucha Libre terms -- rudo, técnico, exótico, máscara, cabellera, arena,","description":"Definitions of roughly a dozen core Lucha Libre terms -- rudo, técnico, exótico, máscara, cabellera, arena,\n    réferi, caída, campeonato, apuesta, mascota, luchador. Use for \"what does cabellera mean\", \"what's a mascota\n    in lucha libre\".","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":"lucha_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}}}}