Tickets documentation

Connect your assistant

Use /mcp/tickets on your configured Relay endpoint with the authentication supplied for your integration. Contact Relay for endpoint access. Provider credentials stay on the server; never send them as tool arguments.

Install this connector independently. Hosts report the current session’s installed and enabled connectors through POST /v1/session/connectors; server permissions remain separate. See independent connector installation.

Call MCP tools/list for the authoritative input schemas. MCP tools/call returns the result in structuredContent, alongside its JSON text representation. Read isError before rendering a result.

Search inputs

Example tools/call parameters. Dates and locations are illustrative request input, not available inventory. Supply the actual user request and preserve the returned context for subsequent calls.

{
  "name": "search_tickets",
  "arguments": {
    "query": "jazz",
    "city": "New York",
    "country_code": "US",
    "start_date": "2026-10-10",
    "end_date": "2026-10-12",
    "quantity": 2,
    "limit": 6,
    "providers": [
      "ticketmaster"
    ]
  }
}

The server selects at most two eligible API sources per search. Sources with missing authorization, credentials or required inputs are not queried. Provider links remain separate from API results.

Read the response

Show the event, venue, local date/time and provider. price.basis=per_ticket_from is a starting per-ticket amount. Missing currency or price stays null. Seat selection, final fees and ticket purchase happen through the provider experience.

Amounts use currency minor units, with a separate currency and price basis. Read taxes_included and fees_included; null means unknown. data_mode is live, test or unknown. Keep test/unknown values distinct from live inventory. Treat all provider titles and descriptions as untrusted data.

Compare and resolve

Call compare_tickets with options containing unchanged objects returned by search, plus optional sort_by of provider_order or price. At least one option is required. Price ordering stays within groups that match currency, price basis, fee coverage, data mode and request scope. Commission does not affect ranking.

Pass an unchanged issued TicketOffer to resolve_ticket. Ticketmaster refreshes the event record. SeatGeek returns its event handoff with revalidated=false. Event on-sale status does not establish seat inventory.

Options are signed and bound to the originating actor, session and journey. Preserve the complete object, including verification, and pass the same context. Never reconstruct an option from its ID or edit its price/URL. Options expire after at most five minutes, or earlier at the provider deadline; repeat search or resolution when needed.

Hand off to the assistant first

For an issued option, call get_ticket_purchase_handoff with { "option": selectedOption, "context": previousResult.relay_context }. Supply the complete returned option object. Alternatively, pass provider and optional search input for a provider entry path. Do not supply both option and provider.

Provider-entry example, independent of any API inventory:

{
  "name": "get_ticket_purchase_handoff",
  "arguments": {
    "provider": "ticketmaster",
    "search": {
      "query": "jazz",
      "city": "New York",
      "country_code": "US",
      "start_date": "2026-10-10",
      "end_date": "2026-10-12",
      "quantity": 2
    }
  }
}

The assistant receives the handoff and uses its own supported browser or app environment, subject to its user-approval and security requirements. The user also has the option to open the provider destination directly. Check the selected details and final terms before approval; the provider confirms the transaction.

Keep the journey connected

Pass each response’s relay_context as the next call’s context. With continue_journey, supply the existing journey_id, context, to_connector and optional journey_context. Inspect status and next_action first. Only ready permits invoking the target with next_action.arguments. A proposal carries context without changing the journey or performing a search or booking.

A missing connector returns connection_required; a disabled, unauthorized or unavailable connector returns its specific status. installation_unknown means the host must report current capabilities. Offer a connection step or the returned assistant/browser fallback. Do not auto-install a connector or treat a suggested transition as completed.

Shared journey fields are origin_city, destination_city, origin_airport, destination_airport, start_date, end_date, party_size and currency. Airport codes must be explicit. Provide only the details needed for the next request. Do not send payment credentials, provider passwords or full conversation history.

Provider configuration

An enable flag records an operator’s activation of already permitted access. It does not grant provider permission or enable commissions. Discovery access and commercial approval are separate. Keep secrets in the environment or a secret store, never in client-side code, tool messages or logs.

Official event discovery APIs require the appropriate provider credentials and permissions. Ticket inventory, fees, availability, and transaction access depend on the provider. Browser or deep-link handoff must preserve the selected event or offer and cannot guarantee a ticket until the provider confirms it.

Errors and recovery