Skip to content
WODiraWODiraWODira Developers

WODira MCP server tools and flows

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

Core

Section titled “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

Athlete

Section titled “Athlete”
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 and OAuth
View today’s bookings athlete_my_box_reservations_today Optional boxIdOrSlug
View my tickets athlete_my_tickets Tickets, event, team, and bib number
View my registrations athlete_my_registrations Payment, category, participants, and check-in state
View my purchases athlete_my_orders Orders, payments, refunds, items, and receipts
Get ticket access or QR athlete_ticket_access Requires a ticketId owned by the athlete
View my sports calendar athlete_my_sports_calendar Competitions, booked classes, and bookmarks
View my results athlete_my_results Rankings, box results, and achievements
View statistics athlete_my_statistics Annual sports and spending summary
Get recommendations athlete_recommended_events Explainable recommendations using history and distance
Summarize my season athlete_season_summary Upcoming races, pending payments, and spending
Search upcoming events athlete_search_upcoming_events Public; forces future published events sorted by date
View upcoming bookmarks athlete_upcoming_bookmarks Short list with limit
Export bookmarks to calendar athlete_my_bookmarks_calendar includeIcs can increase response size

Organizer

Section titled “Organizer”
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
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
Delete a registration organizer_delete_registration Requires ticketId
View full event detail organizer_event_detail Categories, WODs, sponsors, products, and counts
Section titled “Recommended flows”
Flow Sequence
Smoke test hello
Public discovery hello -> search_events
Athlete discovery athlete_my_boxes -> athlete_search_upcoming_events
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_delete_registration

Inputs that matter most

Section titled “Inputs that matter most”
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_update_registration ticketId, update payload, organizationId?, checkedInAt?
organizer_delete_registration ticketId, organizationId?
organizer_event_detail eventIdOrSlug, organizationId?

UI resources

Section titled “UI resources”

Core tools include UI metadata with resourceUri values such as:

ui://wodira/v2/...

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

Private agentic commerce profile

Section titled “Private agentic commerce profile”

athlete_register_event_summary, athlete_register_event, organizer_refund_order_summary, and organizer_refund_order are published only at https://api.wodira.app/mcp/commerce. This profile requires Bearer OAuth with commerce:agentic, a preview, signed token, literal confirmation, and idempotency. Review the preview structuredContent and pass its confirmationToken verbatim to confirmation with the same selection and idempotencyKey; if any value changes, create a new preview with a new key. organizer_create_manual_registration remains withheld from both catalogs.

Documentation resources

Section titled “Documentation resources”

Agents can read wodira://docs/index, wodira://docs/events, wodira://docs/boxes, wodira://docs/programming, and wodira://docs/mcp without leaving the MCP protocol.

Operational security

Section titled “Operational security”
  • Review every write action before approving it.
  • Use organizer_list_my_organizations to avoid operating on the wrong organization.
  • organizer_create_event, organizer_update_registration, and organizer_delete_registration write immediately and have no preview; resolve every value and exact identifier first.
  • Do not share MCP tokens or sessions in public prompts or tickets.
  • If a tool returns checkout links, treat them as sensitive actions.