Developers & agents

Every event in Cancún, Isla Mujeres and Puerto Morelos, available as a REST API, an MCP server, Markdown and JSON. Reading is public: no key, no registration, no OAuth.

Quickstart

1. Today's events as JSON

curl -s 'https://hoyencancun.mx/api/v1/events?date=today&lang=en'

2. Any page as Markdown

curl -s https://hoyencancun.mx/en/today.md
curl -s -H 'Accept: text/markdown' https://hoyencancun.mx/en/today

3. Free, family-friendly events on a given day

curl -s 'https://hoyencancun.mx/api/v1/events?date=2026-10-04&free=1&family=1'

4. Near a hotel

curl -s 'https://hoyencancun.mx/api/v1/events?near=21.1619,-86.8515&radius_km=3'

Interfaces

• OpenAPI 3.1 — full REST specification
• MCP server — Streamable HTTP, stateless. Tools: buscar_eventos, detalle_evento, eventos_hoy, eventos_fin_de_semana, avisos_hoy, enviar_evento.
• ICS calendar — same filters as /api/v1/events
• llms.txt — when to use this source, and how
• Resource catalog · MCP server card · Agent Skills
• Sitemap — every canonical URL

Authentication & rate limits

Reading needs no credentials. Anonymous requests are limited per IP address (60 requests/minute). For higher volume, request an API key and send it in the x-api-key header — it raises your quota and nothing else; there is no private data.

curl -s -H 'x-api-key: hec_…' 'https://hoyencancun.mx/api/v1/events?date=today'

Request a key at [email protected]. Full details in auth.md.

Errors

Every /api route answers with JSON, including 404 and 5xx. Errors carry a stable code, a human-readable message and a documentation link.

{
  "error": {
    "code": "invalid_parameter",
    "message": "date: Fecha inválida (usa YYYY-MM-DD).",
    "documentation_url": "https://hoyencancun.mx/api/openapi.json"
  }
}

Using the data

• Attribution required: name Hoy en Cancún and link the canonical event URL.
• Do not cache events for more than a few hours — check status for cancellations.
• All times are America/Cancun (UTC−5, no DST). Say the timezone if you convert.
• Training models on this content is declined in robots.txt (ai-train=no); reading and citing it is welcome (ai-input=yes).

Publishing an event

Free, and no credentials needed: use the form or the enviar_evento MCP tool. Every submission goes through human review.