Skip to content
MCP server

pretix MCP by usefulapi

Read pretix events, tickets and orders; check attendees in or out with your own account.

Install
Runs
Remotely
Version
1.12.0
Listing updated
4 days ago

About pretix MCP by usefulapi

pretix MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http pretix https://pretix.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://pretix.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pretix": {
      "url": "https://pretix.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pretix": {
      "type": "http",
      "url": "https://pretix.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pretix": {
      "serverUrl": "https://pretix.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pretix": {
      "type": "http",
      "url": "https://pretix.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

pretix_list_organizers
List the organizer accounts this API token can access (slug, name, public URL). A team token sees its own organizer. GET /organizers/.
pretix_get_organizer
One organizer account: slug, name, public URL. GET /organizers/{organizer}/.
pretix_list_events
List the events of an organizer (name, slug, dates, live/test mode, currency, location, whether it is an event series). Filter by search text, live state or date. GET /organizers/{organizer}/events/.
pretix_get_event
One event in full: name, dates, location, currency, live/test mode, presale window, meta data, enabled plugins. GET /organizers/{organizer}/events/{event}/.
pretix_list_subevents
List the dates (sub-events) of an event series, for one event or across all series of the organizer. Each has id, name, dates, location, presale window and price overrides. GET /organizers/{organizer}/events/{event}/subevents/ or /organizers/{organizer}/subevents/.
pretix_get_subevent
One date (sub-event) of an event series. GET /organizers/{organizer}/events/{event}/subevents/{id}/.
pretix_list_items
List the products (ticket types, merchandise) of an event with id, name, default price, tax, active flag, category and variations. GET /organizers/{organizer}/events/{event}/items/.
pretix_get_item
One product with its variations, add-ons and bundles. GET /organizers/{organizer}/events/{event}/items/{id}/.
pretix_list_quotas
List the quotas (capacity pools) of an event: size, the products they cover, closed state and, with with_availability, how many are still available. GET /organizers/{organizer}/events/{event}/quotas/.
pretix_get_quota_availability
How much of a quota is left: available, available_number, total_size and what is using it (pending and paid orders, cart positions, blocking vouchers, waiting list). Values can lag slightly. GET /organizers/{organizer}/events/{event}/quotas/{id}/availability/.
pretix_list_orders
List orders of one event, or of all events of the organizer when no event is given: code, status, email, total, dates, positions, payments, invoice address. Contains customer personal data. Order secrets, order links and payment details are removed. GET /organizers/{organizer}/events/{event}/orders/ or /organizers/{organizer}/orders/.
pretix_get_order
One order by its code (e.g. ABC12): status, customer email and phone, total, positions (tickets), fees, payments, refunds as recorded, invoice address, check-in flags. Contains customer personal data. Secrets, order link and payment details are removed. GET /organizers/{organizer}/events/{event}/orders/{code}/.
pretix_list_order_positions
List the individual tickets (order positions) of one event, or of all events of the organizer when no event is given: attendee name and email, product, variation, price, order code, check-ins, answers. Contains attendee personal data. Ticket secrets are removed. GET /organizers/{organizer}/events/{event}/orderpositions/ or /organizers/{organizer}/orderpositions/.
pretix_list_checkin_lists
List the check-in lists of an event (id, name, the products they admit, event series date, rule settings). Use the list id for check-in status, attendee lists and check-in. GET /organizers/{organizer}/events/{event}/checkinlists/.
pretix_get_checkin_list_status
Live check-in numbers of a check-in list: how many tickets exist, how many are checked in, how many are inside now, broken down per product and variation. GET /organizers/{organizer}/events/{event}/checkinlists/{id}/status/.
pretix_list_checkin_list_positions
The attendee list of a check-in list: tickets with attendee name, product, order code, check-in history and whether the ticket needs attention. Contains attendee personal data. Ticket secrets are removed; check in by position id. GET /organizers/{organizer}/events/{event}/checkinlists/{id}/positions/.
pretix_list_waiting_list
List the waiting list entries of an event: who waits for which product, since when, and whether a voucher was already sent. Contains personal data (name, email, phone). Read-only: no voucher is sent. GET /organizers/{organizer}/events/{event}/waitinglistentries/.
pretix_checkin_position
WRITE: check one ticket in (or out) on a check-in list. Records a real check-in in pretix and cannot be undone from here. Identify the ticket by position_id (from pretix_list_checkin_list_positions) or by ticket_secret (the scanned QR code content). pretix applies its own rules: the call is refused for unpaid, canceled, blocked, already-used or wrong-product tickets (the reason is returned), and i

pretix MCP by usefulapi FAQ

How do I add pretix MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http pretix https://pretix.usefulapi.io/mcp