{"openapi":"3.1.0","info":{"title":"Fiesta (Celebration) API","version":"0.1.0","description":"A fully local Mexico + Spain holidays and festivals guide: holiday lookup and search, month and country listings, a computed Semana Santa calendar derived from a verified Easter-date algorithm, traditions, regional variation and safety guides, and a festival glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://fiesta.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/fiesta/docs"},"termsOfService":"https://connectorbay.com/fiesta/terms"},"servers":[{"url":"https://fiesta.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/fiesta/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/holiday_info":{"post":{"operationId":"holiday_info","summary":"One Mexican or Spanish holiday's description, typical or computed date, country and traditions.","description":"One Mexican or Spanish holiday's description, typical or computed date, country and traditions.\n    Covers Mexican holidays (Día de Reyes, Día de la Candelaria, Semana Santa, Cinco de Mayo, Día de la\n    Independencia, Día de los Muertos, Día de la Virgen de Guadalupe, Las Posadas, Navidad) and Spanish\n    holidays (Las Fallas, Semana Santa, Feria de Abril, San Fermín, La Tomatina, Día de la Hispanidad,\n    Nochebuena/Navidad, Nochevieja, Día de Reyes). For Cinco de Mayo this explicitly clarifies it is NOT\n    Mexican Independence Day. When a name (e.g. \"Semana Santa\") is shared by both countries, add \"Mexico\" or\n    \"Spain\" to disambiguate. Use for \"what is Cinco de Mayo\", \"tell me about La Tomatina\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A holiday name.","examples":["Cinco de Mayo","Día de los Muertos","San Fermín","Semana Santa Spain","Las Fallas"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"holiday_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/holiday_search":{"post":{"operationId":"holiday_search","summary":"Search Mexican and Spanish holidays by keyword across name, description, traditions and foods. Use","description":"Search Mexican and Spanish holidays by keyword across name, description, traditions and foods. Use\n    for \"which holidays involve fireworks\", \"what holidays have a food tradition with grapes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search across holiday name, description, traditions and foods.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"holiday_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/holidays_by_month":{"post":{"operationId":"holidays_by_month","summary":"Which Mexican and Spanish holidays with a known calendar month fall in a given month. Semana Santa","description":"Which Mexican and Spanish holidays with a known calendar month fall in a given month. Semana Santa\n    (movable, Easter-relative) is excluded here since its month varies by year — use computed_date_lookup\n    for that. Feria de Abril's month is an approximate typical month, not a fixed rule. Use for \"what\n    holidays are in December\", \"is there a Mexican or Spanish holiday in August\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"month":{"description":"Calendar month, 1-12.","maximum":12,"minimum":1,"title":"Month","type":"integer"}},"required":["month"],"title":"holidays_by_monthArguments","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/holidays_by_country":{"post":{"operationId":"holidays_by_country","summary":"Every holiday in this guide for one country alone — \"mexico\" or \"spain\". Mexico and Spain are kept","description":"Every holiday in this guide for one country alone — \"mexico\" or \"spain\". Mexico and Spain are kept\n    as two separate, culturally distinct calendars here, not merged. Use for \"what Mexican holidays do you\n    cover\", \"list Spain's festivals\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"\"mexico\" or \"spain\".","examples":["mexico","spain"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"holidays_by_countryArguments","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/computed_date_lookup":{"post":{"operationId":"computed_date_lookup","summary":"The real computed feature: derives the full Holy Week — Domingo de Ramos, Jueves Santo, Viernes","description":"The real computed feature: derives the full Holy Week — Domingo de Ramos, Jueves Santo, Viernes\n    Santo, Sábado de Gloria and Domingo de Pascua (Easter Sunday) — fresh for the given year from a verified\n    Easter-date algorithm (the Anonymous Gregorian / Meeus-Jones-Butcher algorithm, ported from Festejo,\n    ConnectorBay's Brazilian holidays connector), never a hardcoded per-year table. Covers Semana Santa in\n    both Mexico and Spain — pass \"Semana Santa Mexico\" or \"Semana Santa Spain\" to disambiguate. Other\n    holidays here (including Feria de Abril, whose real dates are set annually by the Seville city council\n    rather than derived by a fixed rule) are not computed this way — use holiday_info for their typical\n    timing. Use for \"when is Semana Santa in 2027\", \"what date is Good Friday in Spain in 2030\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"holiday":{"description":"A movable, Easter-relative holiday — currently 'Semana Santa Mexico' or 'Semana Santa Spain'.","examples":["Semana Santa Mexico","Semana Santa Spain"],"minLength":1,"title":"Holiday","type":"string"},"year":{"description":"The year to compute the movable feast's dates for.","maximum":3000,"minimum":1583,"title":"Year","type":"integer"}},"required":["holiday","year"],"title":"computed_date_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/traditions_guide":{"post":{"operationId":"traditions_guide","summary":"The typical foods, customs and activities for a given Mexican or Spanish holiday. Use for \"what do","description":"The typical foods, customs and activities for a given Mexican or Spanish holiday. Use for \"what do\n    people eat at Nochevieja\", \"what do you do during Las Posadas\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"holiday":{"description":"A holiday name.","examples":["Día de los Muertos","Nochevieja","Las Posadas"],"minLength":1,"title":"Holiday","type":"string"}},"required":["holiday"],"title":"traditions_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/regional_variation":{"post":{"operationId":"regional_variation","summary":"Where a holiday differs notably by region within its country — Día de los Muertos in Oaxaca or","description":"Where a holiday differs notably by region within its country — Día de los Muertos in Oaxaca or\n    Pátzcuaro/Janitzio versus elsewhere in Mexico, Spain's Semana Santa in Sevilla versus Málaga versus the\n    starker Castilian style, and more. Returns an empty list with a note for holidays treated as broadly\n    consistent nationwide. Use for \"how is Día de los Muertos different in Oaxaca\", \"is Semana Santa\n    different in Sevilla\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"holiday":{"description":"A holiday name.","examples":["Día de los Muertos","Semana Santa Spain"],"minLength":1,"title":"Holiday","type":"string"}},"required":["holiday"],"title":"regional_variationArguments","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/safety_note":{"post":{"operationId":"safety_note","summary":"A brief, factual safety note for holidays with a real safety consideration — most notably San","description":"A brief, factual safety note for holidays with a real safety consideration — most notably San\n    Fermín's running of the bulls (encierro), which carries a genuine, well-documented injury risk. This\n    recommends following official guidance and does not encourage participation in risky activities. For\n    holidays with no notable safety consideration, returns a neutral note rather than nothing. Use for \"is\n    the running of the bulls dangerous\", \"is La Tomatina safe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"holiday":{"description":"A holiday name.","examples":["San Fermín","La Tomatina"],"minLength":1,"title":"Holiday","type":"string"}},"required":["holiday"],"title":"safety_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/festival_glossary":{"post":{"operationId":"festival_glossary","summary":"Definitions of Mexican and Spanish festival terms (ofrenda, calavera, posada, encierro, tomatina,","description":"Definitions of Mexican and Spanish festival terms (ofrenda, calavera, posada, encierro, tomatina,\n    falla, mascletà, paso, saeta, roscón, caseta, chupinazo, grito, cabalgata). Use for \"what's an ofrenda\",\n    \"what does encierro mean\".","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":"festival_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}}}}