Technical contract

Connection details for custom AI tools.

Use this page when an MCP client, agent, or internal system asks how to connect to Lilypass. Regular organizers can stay on the simpler AI helpers page.

MCP server

Hosted endpoint

https://lilypass.com/mcp

Authentication

Bearer key

Authorization: Bearer lp_live_...

Self-serve rule

Event first

Self-serve accounts create and pay for the event in Lilypass first, then use AI tools for ticket operations and event reads.

Enterprise automation can create or update events when the account has integrations access and the key has the required permission. Self-serve keys should guide users to create the event in Lilypass first.

Ticket Routes

POST/ticketsApiticketsApi:create

Creates a ticket for an existing event through the signed tickets API.

Auth: api_key | Input: TicketsApiCreateInput | Response: TicketsApiCreateResult

GET/ticketsApiticketsApi:list

Lists tickets for an existing event through the signed tickets API.

Auth: api_key | Input: QueryString | Response: TicketsApiListResult

GET/ticketsApi/:ticketIdticketsApi:get

Fetches one ticket through the signed tickets API.

Auth: api_key | Input: PathParam | Response: TicketsApiGetResult

PATCH/ticketsApi/:ticketIdticketsApi:update

Updates one ticket through the signed tickets API.

Auth: api_key | Input: TicketsApiUpdateInput | Response: TicketsApiUpdateResult

DELETE/ticketsApi/:ticketIdticketsApi:delete

Revokes one ticket through the signed tickets API.

Auth: api_key | Input: PathParam | Response: TicketsApiDeleteResult

Event Routes

POST/eventsApieventsApi:create

Creates an event through the signed events API. Requires enterprise automation access, HMAC headers, and an Idempotency-Key header.

Auth: api_key | Input: CreateEventInput | Response: CreateEventResult

GET/eventsApieventsApi:list

Lists existing events through the signed events API with HMAC request signing.

Auth: api_key | Input: QueryString | Response: { items: AdminEventSummary[] }

GET/eventsApi/:eventIdeventsApi:get

Fetches one existing event through the signed events API with HMAC request signing.

Auth: api_key | Input: PathParam | Response: AdminEventSummary

PATCH/eventsApi/:eventIdeventsApi:update

Updates one event through the signed events API. Requires enterprise automation access, HMAC headers, and an Idempotency-Key header.

Auth: api_key | Input: EventsApiUpdateInput | Response: AdminEventSummary