MCP

Usetix includes a hosted Model Context Protocol (MCP) server, so external AI clients can work with your Usetix account through the same organizer tools as the built-in assistant.

Use it when you want ChatGPT, Claude, or another MCP-compatible client to look up event data, create and update events, publish or unpublish them, list or unlist them in the public shop, manage account and event checkout-fee policies, choose whether an event’s end time is shown publicly, show or hide paid prices on ticket PDFs, help with ticket setup, manage complimentary guest lists, analyze privacy-aware shop traffic and conversion, summarize sales, or manage common admin changes from outside the Usetix dashboard.

Setup

You manage MCP connections in your Usetix dashboard under Settings → AI Connectors.

1. Open Settings → AI Connectors.

2. Copy the MCP server URL. For production accounts, the hosted endpoint is:

   https://app.usetix.io/mcp
   

3. Create a custom MCP connector in ChatGPT, Claude, or another MCP client.
4. Paste the MCP server URL.
5. Sign in to Usetix, choose the account to connect, and approve access.

Active connections appear under Settings → AI Connectors and can be revoked at any time.

Authentication

MCP connections use OAuth. External clients do not need a manually created API token.

URL	Purpose
https://app.usetix.io/mcp	JSON-RPC MCP server endpoint.
https://app.usetix.io/.well-known/oauth-protected-resource	Protected resource metadata for MCP clients.
https://app.usetix.io/.well-known/oauth-authorization-server	OAuth authorization server metadata.

The OAuth flow uses authorization-code grants with PKCE. Access is account-scoped: a connection approved for one Usetix account only sees that account.

Scopes

Usetix exposes two MCP scopes:

Scope	Access
usetix:read	Read account data, list events, inspect privacy-aware analytics, look up orders and customers, summarize sales, and inspect setup status.
usetix:write	Make changes through organizer tools, such as creating, updating, publishing, listing, or unlisting events and managing tickets, guest lists, venues, performers, promo codes, shop FAQs, legal pages, and account settings.

Read-only tool calls work with usetix:read. Tool calls that change data require usetix:write.

Available tools

The MCP server exposes the same task-oriented tools used by the Usetix assistant, including tools for:

• creating, updating, duplicating, publishing or unpublishing events, listing or unlisting them in public shop overviews, and managing their checkout-fee policy and public end time
• managing ticket types, custom checkout questions, event FAQs, and private event downloads
• managing complimentary guest lists (GA, standing, and numbered seats)
• managing venues, performers, event lineups, promo codes, and shop FAQs
• updating account settings and legal pages, including whether ticket PDFs show the paid price
• checking setup status
• looking up orders, guest parties, and customers
• producing privacy-aware historical and Live View analytics, sales summaries, and revenue reports
• preparing refunds

Checkout fees

The built-in assistant and MCP clients share the same account and event fee tools:

• account_settings with action show reads the account defaults. Action update accepts platform_fee_payer (organizer or buyer), custom_fee_fixed_amount, and custom_fee_percentage. The fixed and percentage components can be combined.
• create_event accepts those fields plus checkout_fee_policy. Omit them to inherit the account defaults. Providing an override without a policy implies custom.
• update_event sets checkout_fee_policy to custom for an event-specific override or account_default to restore inheritance.
• list_events with include_checkout_fees: true returns each event’s effective payer and additional fee, whether inherited or custom.

Changes apply only to future orders. Existing orders keep their snapshotted fee and tax totals. See the Checkout fees API for the matching JSON endpoints and response shapes.

Ticket price visibility

The built-in AI assistant and MCP clients share the account_settings tool. Its show_price_on_ticket boolean controls whether generated ticket PDFs include the paid price for the whole account.

To hide the price, call:

{"action":"update","show_price_on_ticket":false}

Pass true to show it again. In the built-in assistant, you can say “Hide the price on ticket PDFs” or “Show ticket prices again.” The setting does not change checkout prices, order totals, or invoices.

Doors / entry time

The event creation and update tools accept an optional doors_open_at value in ISO 8601 format. Use it for the time guests may enter, separately from starts_at, which remains the event’s start time. The doors time must be at or before the start time.

Omit doors_open_at when creating an event if no separate entry time was provided. To remove an existing doors time with the event update tool, pass an empty string. Event listings include the doors time whenever it is set.

Guest list

The built-in assistant and MCP share manage_guest_list. Guest-list admissions are complimentary, consume real inventory, and skip checkout. They are not customers and cannot be refunded with prepare_refund.

Action	Use
list	Parties on an event. Optional query and filter (all, expected, arrived).
tickets	Eligible standard tickets and whether they are ga, standing, or places.
places	Available numbered seats for a ticket. Returns stable place_keys.
add	Create a party. GA uses party_size. Standing uses the single area when there is only one. Numbered seats require place_keys from places. Never auto-assign.
update	Lead name, delivery email, staff note, companion names. deliver: true emails tickets.
cancel	Remove a party that has not been checked in.
cancel_admission	Release one unredeemed companion.
move_seat	Reassign one numbered admission. Destination comes from places.

Group tickets, whole tables, and numbered-seat walk-ins are out of scope. Linked wheelchair and companion seats cannot be moved individually. Ask before cancel or cancel_admission.

Full product notes: Guest list. JSON contract: Guest list API.

File attachments from external AI clients are not available through MCP yet. Private event downloads can currently be listed or removed.

Safety

Connections can be revoked from Settings → AI Connectors. After revocation, the external AI client must sign in again before it can use Usetix tools.

The MCP server also gives clients account instructions that tell them to ask before destructive or high-impact actions such as publishing, unpublishing, archiving, deleting, preparing refunds, removing guest-list parties or admissions, or broad account-setting changes.

Need help connecting a client? Contact support.