MCP tools and flows

Choose tools by intent. Some tools require an authenticated athlete or organizer user, while others operate on public data.

Core

Intent	Tool	Notes
Verify connectivity	`hello`	MCP server smoke test
Search public events	`search_events`	Search by text, date, location, status, type, price, team size, or modality

Intent	Tool	Notes
View my boxes	`athlete_my_boxes`	Membership, credits, timezone, quick links
View today’s classes in a box	`boxes_classes_today`	Requires `boxIdOrSlug`
View today’s bookings	`athlete_my_box_reservations_today`	Optional `boxIdOrSlug`
View my tickets	`athlete_my_tickets`	Tickets, event, team, and bib number
Search upcoming events	`athlete_search_upcoming_events`	Defaults to future, published, date-sorted
View upcoming bookmarks	`athlete_upcoming_bookmarks`	Short list with `limit`
Export bookmarks to calendar	`athlete_my_bookmarks_calendar`	`includeIcs` can increase response size
Preview registration checkout	`athlete_register_event_summary`	Use before creating checkout
Create registration checkout	`athlete_register_event`	Creates registration and returns payment URL

Intent	Tool	Notes
List available organizations	`organizer_list_my_organizations`	Recommended first step to get `organizationId`
Create an event	`organizer_create_event`	Full event creation with categories, pricing, logistics, registration
List events	`organizer_list_events`	Events with registrations, orders, and summary metrics
View basic metrics	`organizer_event_metrics_basic`	Requires `eventIdOrSlug`; accepts `organizationId`
Create offline registration	`organizer_create_manual_registration`	Offline or special cases
Search orders	`organizer_search_orders`	Payments, orders, and related tickets
Search athlete tickets	`organizer_search_athlete_tickets`	Participants, categories, and order status
Edit a registration	`organizer_update_registration`	Participants, team, bib number, and check-in
Refund or cancel an order	`organizer_refund_order`	Changes payment/order state
Delete a registration	`organizer_delete_registration`	Requires `ticketId`
View full event detail	`organizer_event_detail`	Categories, WODs, sponsors, products, and counts

Flow	Sequence
Smoke test	`hello`
Public discovery	`hello` -> `search_events`
Athlete discovery	`athlete_my_boxes` -> `athlete_search_upcoming_events`
Registration purchase	`athlete_register_event_summary` -> `athlete_register_event`
Organizer operation	`organizer_list_my_organizations` -> `organizer_list_events` -> `organizer_event_metrics_basic`
Organizer incident management	`organizer_search_orders` / `organizer_search_athlete_tickets` -> `organizer_update_registration` / `organizer_refund_order` / `organizer_delete_registration`

Tool	Important inputs
`search_events`	text, `dateRange`, location, status, type, price, team size, modality
`athlete_search_upcoming_events`	same filters as `search_events`, with athlete defaults
`boxes_classes_today`	`boxIdOrSlug`
`athlete_my_box_reservations_today`	`boxIdOrSlug?`
`athlete_upcoming_bookmarks`	`limit`
`athlete_my_bookmarks_calendar`	`limit`, `includeIcs`
`organizer_list_events`	search filters and `organizationId?`
`organizer_event_metrics_basic`	`eventIdOrSlug`, `organizationId?`
`organizer_create_manual_registration`	manual payload, `organizationId?`, `checkedInAt?`
`organizer_update_registration`	`ticketId`, update payload, `organizationId?`, `checkedInAt?`
`organizer_refund_order`	`orderId`, refund/cancel payload, `organizationId?`
`organizer_delete_registration`	`ticketId`, `organizationId?`
`organizer_event_detail`	`eventIdOrSlug`, `organizationId?`

Core tools include UI metadata with resourceUri values such as:

ui://wodira/...

Clients that support MCP Apps can render these interfaces. Clients without UI support still receive useful text/JSON responses for the model.

Review every write action before approving it.
Use organizer_list_my_organizations to avoid operating on the wrong organization.
Do not use athlete_register_event without first reviewing athlete_register_event_summary.
Do not share MCP tokens or sessions in public prompts or tickets.
If a tool returns checkout links, treat them as sensitive actions.