Tools y flujos del servidor MCP de WODira

Elige tools por intención. Algunas herramientas requieren usuario autenticado como athlete u organizer y otras operan sobre datos públicos.

Core

Intención	Tool	Notas
Verificar conectividad	`hello`	Smoke test del servidor MCP
Buscar eventos públicos	`search_events`	Búsqueda por texto, fecha, ubicación, estado, tipo, precio, equipo o modalidad

Athlete

Intención	Tool	Notas
Ver mis boxes	`athlete_my_boxes`	Membresía, créditos, timezone y enlaces rápidos
Ver clases de hoy de un box	`boxes_classes_today`	Requiere `boxIdOrSlug` y OAuth
Ver mis reservas de hoy	`athlete_my_box_reservations_today`	`boxIdOrSlug` opcional
Ver mis tickets	`athlete_my_tickets`	Tickets, evento, equipo y dorsal
Ver mis inscripciones	`athlete_my_registrations`	Estado de pago, categoría, participantes y check-in
Ver mis compras	`athlete_my_orders`	Órdenes, pagos, reembolsos, artículos y recibos
Obtener acceso o QR de ticket	`athlete_ticket_access`	Requiere un `ticketId` propiedad del atleta
Consultar agenda deportiva	`athlete_my_sports_calendar`	Competiciones, clases reservadas y bookmarks
Consultar resultados	`athlete_my_results`	Rankings, resultados de box y logros
Consultar estadísticas	`athlete_my_statistics`	Resumen deportivo y económico anual
Recibir recomendaciones	`athlete_recommended_events`	Recomendaciones explicables por historial y distancia
Resumir temporada	`athlete_season_summary`	Próximas carreras, pagos pendientes e inversión
Buscar próximos eventos	`athlete_search_upcoming_events`	Pública; fuerza futuros publicados y orden por fecha
Ver bookmarks próximos	`athlete_upcoming_bookmarks`	Lista corta con `limit`
Exportar bookmarks a calendario	`athlete_my_bookmarks_calendar`	`includeIcs` puede hacer crecer la respuesta

Organizer

Intención	Tool	Notas
Listar organizaciones disponibles	`organizer_list_my_organizations`	Primer paso recomendado para obtener `organizationId`
Crear evento	`organizer_create_event`	Alta completa con categorías, pricing, logística y ventana de inscripción
Listar eventos	`organizer_list_events`	Eventos con registros, órdenes y métricas resumidas
Ver métricas básicas	`organizer_event_metrics_basic`	Requiere `eventIdOrSlug`; admite `organizationId`
Buscar órdenes	`organizer_search_orders`	Pagos, órdenes y tickets relacionados
Buscar tickets de atletas	`organizer_search_athlete_tickets`	Participantes, categorías y estado de orden
Editar inscripción	`organizer_update_registration`	Participantes, equipo, dorsal y check-in
Borrar inscripción	`organizer_delete_registration`	Requiere `ticketId`
Ver detalle completo de evento	`organizer_event_detail`	Categorías, WODs, sponsors, products y conteos

Flujos recomendados

Flujo	Secuencia
Smoke test	`hello`
Descubrimiento público	`hello` → `search_events`
Descubrimiento athlete	`athlete_my_boxes` → `athlete_search_upcoming_events`
Operación organizer	`organizer_list_my_organizations` → `organizer_list_events` → `organizer_event_metrics_basic`
Gestión de incidentes organizer	`organizer_search_orders` / `organizer_search_athlete_tickets` → `organizer_update_registration` / `organizer_delete_registration`

Inputs que más importan

Tool	Inputs importantes
`search_events`	texto, `dateRange`, ubicación, status, type, price, team size, modality
`athlete_search_upcoming_events`	mismos filtros que `search_events`, con defaults de atleta
`boxes_classes_today`	`boxIdOrSlug`
`athlete_my_box_reservations_today`	`boxIdOrSlug?`
`athlete_upcoming_bookmarks`	`limit`
`athlete_my_bookmarks_calendar`	`limit`, `includeIcs`
`organizer_list_events`	filtros de búsqueda y `organizationId?`
`organizer_event_metrics_basic`	`eventIdOrSlug`, `organizationId?`
`organizer_update_registration`	`ticketId`, payload de actualización, `organizationId?`, `checkedInAt?`
`organizer_delete_registration`	`ticketId`, `organizationId?`
`organizer_event_detail`	`eventIdOrSlug`, `organizationId?`

Recursos UI

Las tools principales incluyen metadata de UI con resourceUri del tipo:

ui://wodira/v2/...

Los clientes que soporten MCP Apps pueden renderizar esas interfaces. Los clientes que no soporten UI siguen recibiendo respuestas de texto/JSON útiles para el modelo.

Perfil privado de comercio agéntico

athlete_register_event_summary, athlete_register_event, organizer_refund_order_summary y organizer_refund_order solo se publican en https://api.wodira.app/mcp/commerce. Ese perfil requiere bearer OAuth con commerce:agentic, una previsualización, token firmado, confirmación literal e idempotencia. Revisa el structuredContent del preview y pasa su confirmationToken literalmente a la confirmación, junto con la misma selección y idempotencyKey; si cambia algún valor, genera un preview nuevo con otra clave. organizer_create_manual_registration permanece retenida de ambos catálogos.

Recursos de documentación

Los agentes pueden consultar wodira://docs/index, wodira://docs/events, wodira://docs/boxes, wodira://docs/programming y wodira://docs/mcp sin salir del protocolo MCP.

Seguridad operativa

Revisa cada acción de escritura antes de aprobarla.
Usa organizer_list_my_organizations para evitar operar sobre la organización equivocada.
organizer_create_event, organizer_update_registration y organizer_delete_registration escriben inmediatamente y no ofrecen preview; resuelve primero todos los valores y los identificadores exactos.
No compartas tokens ni sesiones MCP en prompts o tickets públicos.
Si una tool devuelve enlaces de checkout, trátalos como acciones sensibles.