Fiesta (Celebration)

Fiesta (Celebration) — connector documentation

• MCP endpoint: https://fiesta.connectorbay.com/mcp
• REST API: POST https://fiesta.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://fiesta.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://fiesta.connectorbay.com/health · Tool schemas: https://fiesta.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/fiesta · agent@connectorbay.com

What Fiesta (Celebration) is for

Mexico and Spain share a language, but their holidays and festivals grew from different histories, and this connector treats them that way: two related, culturally distinct calendars, never merged into one "Hispanic" reference. The question that comes up whenever one of these holidays is mentioned — is Cinco de Mayo actually Mexican Independence Day (it isn't), when does Semana Santa fall this year in Mexico or in Spain, what do Spaniards actually eat at midnight on New Year's Eve, is the running of the bulls dangerous, how is Día de los Muertos different in Oaxaca — answered from one hand-curated, dual-country reference, with the one part that genuinely changes every year (the Easter-tied Semana Santa) computed live instead of guessed or hardcoded.

What it does

One holiday's description, typical or computed date, country and traditions (holiday_info) — covering Mexican holidays (Día de Reyes, Día de la Candelaria, Semana Santa, Cinco de Mayo, Día de la Independencia, Día de los Muertos, Día de la Virgen de Guadalupe, Las Posadas, Navidad) and Spanish holidays (Las Fallas, Semana Santa, Feria de Abril, San Fermín/Sanfermines, La Tomatina, Día de la Hispanidad, Nochebuena/Navidad, Nochevieja, Día de Reyes). It explicitly corrects a common misconception: Cinco de Mayo is NOT Mexican Independence Day — that's September 16 — and is a comparatively minor holiday even in Mexico outside Puebla state, celebrated far more widely in the United States than in Mexico itself. A keyword search across name, description, traditions and foods (holiday_search); which holidays with a known calendar month fall in a given month, pointing to computed_date_lookup for Semana Santa (holidays_by_month); every holiday for one country alone, "mexico" or "spain" (holidays_by_country); the real computed feature — the full Holy Week (Domingo de Ramos through Domingo de Pascua) for Semana Santa in either country, derived fresh from a verified Easter-date algorithm for any year, never a hardcoded table (computed_date_lookup); the typical foods, customs and activities for a holiday (traditions_guide); where a holiday differs notably by region within its country — Día de los Muertos in Oaxaca or Pátzcuaro/Janitzio versus elsewhere in Mexico, Spain's Semana Santa in Sevilla versus the starker Castilian style, and more (regional_variation); a brief, factual safety note for holidays with a real safety consideration, most notably San Fermín's running of the bulls (safety_note); and a glossary of festival terms — ofrenda, calavera, posada, encierro, tomatina, falla, paso, saeta and more (festival_glossary).

The real computation

Semana Santa in both Mexico and Spain is pinned to the date of Easter Sunday, which itself moves every year. This connector implements the actual Easter-date algorithm — the Anonymous Gregorian algorithm, also called the Meeus/Jones/Butcher algorithm — rather than storing a lookup table of future years, ported from Festejo, ConnectorBay's Brazilian holidays connector, where the identical implementation is independently verified against the same four historical Easter dates (2024-03-31, 2025-04-20, 2018-04-01, 2000-04-23). From Easter Sunday, computed_date_lookup derives every other Holy Week day (Palm Sunday, Holy Thursday, Good Friday, Holy Saturday) as a fixed day-offset — pure arithmetic, verified in tests/test_local.py.

A note on safety

San Fermín's daily encierro (running of the bulls) and, to a lesser extent, La Tomatina's dense, slippery crowd carry real, documented injury risk. safety_note states this factually and points to official guidance; it does not encourage participation, and this connector never romanticizes the risk.

What it is not

Not a live event calendar or ticketing service, and not a substitute for official municipal or tourism-board information — exact dates for festivals like Las Fallas, San Fermín, La Tomatina or Feria de Abril are set or confirmed annually by local authorities, and Semana Santa's non-Holy-Week civic logistics (school calendars, transit) vary by country and year. It is also not an exhaustive inventory of every Mexican or Spanish festival: the holidays covered are a hand-picked, well-known sample of each country (9 each), not a full state-by-state or comunidad-by-comunidad listing.

Tools

Lookup & Search

holiday_info — One Mexican or Spanish holiday's description, typical or computed date, country and traditions. Covers Mexican holidays (Día de Reyes, Día de la Candelaria, Semana Santa, Cinco de Mayo, Día de la Independencia, Día de los Muertos, Día de la Virgen de Guadalupe, Las Posadas, Navidad) and Spanish holidays (Las Fallas, Semana Santa, Feria de Abril, San Fermín, La Tomatina, Día de la Hispanidad, Nochebuena/Navidad, Nochevieja, Día de Reyes). For Cinco de Mayo this explicitly clarifies it is NOT Mexican Independence Day. When a name (e.g. "Semana Santa") is shared by both countries, add "Mexico" or "Spain" to disambiguate. Use for "what is Cinco de Mayo", "tell me about La Tomatina". Args: name.

holiday_search — Search Mexican and Spanish holidays by keyword across name, description, traditions and foods. Use for "which holidays involve fireworks", "what holidays have a food tradition with grapes". Args: query.

holidays_by_month — Which Mexican and Spanish holidays with a known calendar month fall in a given month. Semana Santa (movable, Easter-relative) is excluded here since its month varies by year — use computed_date_lookup for that. Feria de Abril's month is an approximate typical month, not a fixed rule. Use for "what holidays are in December", "is there a Mexican or Spanish holiday in August". Args: month.

holidays_by_country — Every holiday in this guide for one country alone — "mexico" or "spain". Mexico and Spain are kept as two separate, culturally distinct calendars here, not merged. Use for "what Mexican holidays do you cover", "list Spain's festivals". Args: country.

Computed Calendar

computed_date_lookup — The real computed feature: derives the full Holy Week — Domingo de Ramos, Jueves Santo, Viernes Santo, Sábado de Gloria and Domingo de Pascua (Easter Sunday) — fresh for the given year from a verified Easter-date algorithm (the Anonymous Gregorian / Meeus-Jones-Butcher algorithm, ported from Festejo, ConnectorBay's Brazilian holidays connector), never a hardcoded per-year table. Covers Semana Santa in both Mexico and Spain — pass "Semana Santa Mexico" or "Semana Santa Spain" to disambiguate. Other holidays here (including Feria de Abril, whose real dates are set annually by the Seville city council rather than derived by a fixed rule) are not computed this way — use holiday_info for their typical timing. Use for "when is Semana Santa in 2027", "what date is Good Friday in Spain in 2030". Args: holiday, year.

Traditions & Regions

traditions_guide — The typical foods, customs and activities for a given Mexican or Spanish holiday. Use for "what do people eat at Nochevieja", "what do you do during Las Posadas". Args: holiday.

regional_variation — Where a holiday differs notably by region within its country — Día de los Muertos in Oaxaca or Pátzcuaro/Janitzio versus elsewhere in Mexico, Spain's Semana Santa in Sevilla versus Málaga versus the starker Castilian style, and more. Returns an empty list with a note for holidays treated as broadly consistent nationwide. Use for "how is Día de los Muertos different in Oaxaca", "is Semana Santa different in Sevilla". Args: holiday.

Safety

safety_note — A brief, factual safety note for holidays with a real safety consideration — most notably San Fermín's running of the bulls (encierro), which carries a genuine, well-documented injury risk. This recommends following official guidance and does not encourage participation in risky activities. For holidays with no notable safety consideration, returns a neutral note rather than nothing. Use for "is the running of the bulls dangerous", "is La Tomatina safe". Args: holiday.

Reference

festival_glossary — Definitions of Mexican and Spanish festival terms (ofrenda, calavera, posada, encierro, tomatina, falla, mascletà, paso, saeta, roscón, caseta, chupinazo, grito, cabalgata). Use for "what's an ofrenda", "what does encierro mean". Args: term.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/fiesta/support

Fiesta (Celebration) — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Fiesta (Celebration) is. Fiesta (Celebration) is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated Mexico + Spain holidays and festivals guide: holiday lookup and search, holidays by month or country, a computed Semana Santa calendar for any year, traditions, regional-variation and safety guides, and a festival glossary. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of each tool call — a holiday name, a search keyword, a month, a country ("mexico" or "spain"), a year, or a glossary term — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from a bundled, hand-curated reference file plus arithmetic, and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything. Semana Santa's dates are computed on the fly from the year you supply using a public date algorithm; nothing about that computation is retained after the response is returned.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and answered locally, and calendar math runs in-process. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Fiesta (Celebration) is a general-audience service operated by the adult using the assistant. It describes Mexican and Spanish holidays and festivals factually, including brief factual safety context for events like San Fermín's running of the bulls, and does not collect data from or target children.

Changes. We will post changes here with a new effective date.

Fiesta (Celebration) — Terms of Service

Effective 24 September 2026. These terms govern use of the Fiesta (Celebration) connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Fiesta (Celebration) returns a hand-curated Mexico + Spain holidays and festivals guide — holiday descriptions, traditions and foods; holidays by month or country; a computed per-year Semana Santa calendar; regional-variation and safety guides; and a glossary — from data hand-curated and verified at build time, plus Semana Santa dates computed at request time from a public date algorithm. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Not an official calendar, and not exhaustive. Fiesta (Celebration) is an independent reference tool, not affiliated with or endorsed by the governments of Mexico or Spain, any Mexican state or Spanish comunidad autónoma, or any festival organizer (including the City of Pamplona, the City of Valencia, or the City of Buñol). Exact dates and logistics for annually-scheduled festivals (Las Fallas, San Fermín, La Tomatina, Feria de Abril) are set or confirmed by local authorities each year — verify a specific year's official dates independently before travel. The holidays listed are a hand-picked sample of each country, not a complete state-by-state or region-by-region inventory.
3. Computed dates. Semana Santa's dates (Domingo de Ramos through Domingo de Pascua) are calculated from a well-known public algorithm for the date of Easter Sunday. We believe this computation to be accurate but make no warranty against calculation error; verify a legally significant date independently.
4. Safety information is not a guarantee. Where the Service notes a safety consideration (for example, San Fermín's running of the bulls), that note is general factual context, not safety advice specific to you, and not a substitute for official event guidance, your own judgment, or local authorities' instructions. We do not encourage participation in any activity carrying injury risk.
5. Acceptable use. Automated use within the published rate limits is welcome.
6. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
7. Data. Our Privacy Policy describes what we process. In short: your query is answered from a bundled reference file plus arithmetic, and nothing is stored.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service, including any loss arising from participation in an activity described by the Service. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/fiesta

Fiesta (Celebration) support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://fiesta.connectorbay.com/mcp
• REST API: https://fiesta.connectorbay.com/openapi.json
• Live status: https://fiesta.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Fiesta (Celebration) never asks for them.