MCP de WODira

El MCP de WODira permite que clientes como Codex, Claude Code, Cursor, Gemini CLI o apps de ChatGPT consulten y operen sobre eventos, boxes, reservas, tickets y herramientas de organizador usando el Model Context Protocol.

Endpoint canónico:

https://api.wodira.app/mcp

Usa este endpoint cuando el cliente soporte MCP remoto por Streamable HTTP. El transporte SSE existe como compatibilidad heredada, pero no es la opción recomendada para nuevas integraciones.

Discovery y OAuth

WODira publica metadata OAuth 2.1 para que los clientes no tengan que asumir endpoints internos:

Recurso	URL
Protected resource metadata	`https://api.wodira.app/.well-known/oauth-protected-resource/mcp`
Authorization server metadata	`https://api.wodira.app/.well-known/oauth-authorization-server`
OpenID configuration	`https://api.wodira.app/.well-known/openid-configuration`

El recurso/audience esperado del access token es:

https://api.wodira.app/mcp

Scope mínimo requerido:

profile

Los clientes compatibles deberían usar discovery y abrir el login/consent de WODira durante el flujo OAuth. También se acepta una sesión Better Auth válida si el cliente ejecuta la conexión desde un navegador autenticado.

Transports

Transport	Endpoint	Estado	Uso recomendado
Streamable HTTP	`https://api.wodira.app/mcp`	Activo	Clientes remotos modernos con OAuth
SSE	`https://api.wodira.app/mcp/sse` + `/mcp/messages`	Legado	Solo si tu cliente no soporta Streamable HTTP

La conexión inicial crea una sesión MCP. Las siguientes llamadas usan el header mcp-session-id que gestiona el cliente MCP.

Primer test

Una vez conectado el cliente, ejecuta la tool:

hello

Respuesta esperada:

Hello from WODira MCP

Si hello funciona, el transporte, la autenticación y el descubrimiento básico de tools están operativos.

Qué puedes hacer

El servidor expone tools para tres perfiles:

Perfil	Capacidades
Público	Buscar eventos publicados y obtener enlaces de evento
Athlete	Ver boxes, clases de hoy, reservas, tickets, bookmarks y calendario
Organizer	Listar organizaciones, crear eventos, consultar métricas, gestionar órdenes, tickets e inscripciones

Para flujos de organizador, empieza por organizer_list_my_organizations y usa el organizationId devuelto en las tools que lo aceptan.

Buenas prácticas

Conecta siempre contra https://api.wodira.app/mcp salvo que estés en un entorno local controlado.
Usa OAuth del cliente MCP cuando esté disponible.
Revisa las tools antes de permitir acciones de escritura como crear eventos, reembolsar órdenes o borrar inscripciones.
No pegues access tokens en prompts, issues, repositorios ni documentación pública.
Usa hello como smoke test y después elige tools por intención, no por nombre.