MCP integration

Overview

Connect a standard Streamable HTTP MCP client to POST /api/public/mcp. The official SDK serves modern per-request discovery and legacy stateless clients. GET /api/public/mcp.json is a discovery document, not the transport itself.

No API key is required for public read tools. Organizer webhooks use authenticated POST /api/me/webhooks separately.

Manifest URL

Fetch GET /api/public/mcp.json for schemaVersion, tools, resources, and documentation links.

Tools

• list_public_activities → the same PUBLIC search/filter/cursor service as GET /api/public/activities
• get_public_activity → the same PUBLIC-only reader as GET /api/public/activity (exactly one id or shareToken)
• search_places → GET /api/public/places/search (q required)
• list_countries → GET /api/public/countries (q, lang)
• platform_stats → GET /api/public/platform-stats

Resources

• llms.txt — curated URL index for crawlers
• openapi — GET /api/public/openapi.json full REST schema
• ai-docs — /ai structured product reference

Webhooks for organizers

Live HTTPS webhooks: registration.confirmed, attendance.showed_up, activity.cancelled.

Subscribe via POST /api/me/webhooks when the agent acts on behalf of a signed-in organizer. Event catalog: GET /api/public/webhooks/events.