Ir al contenido

Tools y flujos MCP

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

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
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
Ver mis reservas de hoy athlete_my_box_reservations_today boxIdOrSlug opcional
Ver mis tickets athlete_my_tickets Tickets, evento, equipo y dorsal
Buscar próximos eventos athlete_search_upcoming_events Defaults a 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
Previsualizar inscripción athlete_register_event_summary Úsala antes de crear checkout
Crear checkout de inscripción athlete_register_event Crea inscripción y devuelve sesión de pago
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
Alta manual offline organizer_create_manual_registration Casos offline o especiales
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
Reembolsar o cancelar orden organizer_refund_order Cambia estado de pago/orden
Borrar inscripción organizer_delete_registration Requiere ticketId
Ver detalle completo de evento organizer_event_detail Categorías, WODs, sponsors, products y conteos
Flujo Secuencia
Smoke test hello
Descubrimiento público hellosearch_events
Descubrimiento athlete athlete_my_boxesathlete_search_upcoming_events
Compra de inscripción athlete_register_event_summaryathlete_register_event
Operación organizer organizer_list_my_organizationsorganizer_list_eventsorganizer_event_metrics_basic
Gestión de incidentes organizer organizer_search_orders / organizer_search_athlete_ticketsorganizer_update_registration / organizer_refund_order / organizer_delete_registration
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_create_manual_registration payload manual, organizationId?, checkedInAt?
organizer_update_registration ticketId, payload de actualización, organizationId?, checkedInAt?
organizer_refund_order orderId, payload de refund/cancel, organizationId?
organizer_delete_registration ticketId, organizationId?
organizer_event_detail eventIdOrSlug, organizationId?

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

ui://wodira/...

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.

  • Revisa cada acción de escritura antes de aprobarla.
  • Usa organizer_list_my_organizations para evitar operar sobre la organización equivocada.
  • No uses athlete_register_event sin haber revisado antes athlete_register_event_summary.
  • No compartas tokens ni sesiones MCP en prompts o tickets públicos.
  • Si una tool devuelve enlaces de checkout, trátalos como acciones sensibles.