Ticketsauce MCP by usefulapi

Working · 1.7 s

io.usefulapi/ticketsaucev1.0.0 Domain verified

Read Ticketsauce events, orders and ticket check-in IDs (read-only).

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://ticketsauce.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

ticketsauce_get_event Read-only

One event by id or slug: everything in the list plus summary and description (text and HTML), order_count and ticket_count (tickets sold, not refunded or voided). Replies are cached for an hour. GET /v2/event/{id_or_slug}.

eventstring, required

Event id (UUID) or event slug, as returned by ticketsauce_list_events.

photosboolean

Include the photo gallery records.

include_performersboolean

Include the performers.

Tools (5)

ticketsauce_get_event

read-only

Argument	Type	Description
event*	string	Event id (UUID) or event slug, as returned by ticketsauce_list_events.
photos	boolean	Include the photo gallery records.
include_performers	boolean	Include the performers.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event"
  ],
  "properties": {
    "event": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Event id (UUID) or event slug, as returned by ticketsauce_list_events."
    },
    "photos": {
      "type": "boolean",
      "description": "Include the photo gallery records."
    },
    "include_performers": {
      "type": "boolean",
      "description": "Include the performers."
    }
  }
}

ticketsauce_get_order

One order by id, with its buyer details, totals and its tickets (ticket type, name, price, redeemed state, promo code). Contains personal data. Replies are cached for an hour. GET /v2/order/{order_id}.

read-only

Argument	Type	Description
order_id*	string	Order id (UUID) from ticketsauce_list_orders.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Order id (UUID) from ticketsauce_list_orders."
    }
  }
}

ticketsauce_list_checkin_ids

The ticket check-in ids of one event, for door/scanning reconciliation (the API documents no response fields; the reply is returned as is). Paged: per_page up to 5000, then pass next_page. Replies are cached for 5 minutes. GET /v2/tickets/checkin_ids/{event_id}.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
event_id*	string	Event id (UUID) from ticketsauce_list_events.
per_page	integer	Ids per page, 1-5000 (default 1000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Event id (UUID) from ticketsauce_list_events."
    },
    "per_page": {
      "type": "integer",
      "maximum": 5000,
      "description": "Ids per page, 1-5000 (default 1000).",
      "exclusiveMinimum": 0
    }
  }
}

ticketsauce_list_events

List the events you own on Ticketsauce with id, name, slug, start/end (local and UTC), venue address, timezone, organization, privacy type, whether tickets are on sale, and the event and ticket-shop URLs. Filter by start/end/created dates (yyyy-mm-dd, UTC), a phrase such as this_weekend, organization or partner. The API has no paging for events. Use the event id for orders and check-ins. GET /v2/events.

read-only

Argument	Type	Description
sort_by	string	Sort field (default date).
sort_dir	string	Sort direction (default asc).
end_after	string	Events ending on/after this date, yyyy-mm-dd.
end_before	string	Events ending on/before this date, yyyy-mm-dd.
partner_id	string	Only events of this partner.
active_only	boolean	Only active events (the API default is true).
start_after	string	Events starting on/after this date, yyyy-mm-dd.
privacy_type	string	public (API default), unlisted or all.

ticketsauce_list_orders

Orders of one event, oldest first by default (pass sort_dir desc for newest first): order id, status, buyer name, email, phone and address, totals (total_paid, refund_amount, taxes, fees), promo code, ticket_count, paid date. Contains your customers' personal data. Filter by order or modified dates, a phrase, buyer email or last name (exact match), totals, or promo use; optionally embed tickets, questionnaire answers and line-item fees. Paged: per_page up to 500, then pass next_page. Replies are cached for an hour. GET /v2/orders/{event_id}.

read-only

Argument	Type	Description
q	string	Exact buyer email address or last name.
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
sort_by	string	Sort field (default date).
event_id*	string	Event id (UUID) from ticketsauce_list_events.
per_page	integer	Orders per page, 1-500 (default 100).
sort_dir	string	Sort direction (default asc).
total_above	number	Only orders with a total greater than this.

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "sort_by": { "enum": [ "date", "name", "city" ], "type": "string", "description": "Sort field (default date)." }, "sort_dir": { "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction (default asc)." }, "end_after": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events ending on/after this date, yyyy-mm-dd." }, "end_before": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events ending on/before this date, yyyy-mm-dd." }, "partner_id": { "type": "string", "maxLength": 100, "minLength": 1, "description": "Only events of this partner." }, "active_only": { "type": "boolean", "description": "Only active events (the API default is true)." }, "start_after": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events starting on/after this date, yyyy-mm-dd." }, "privacy_type": { "enum": [ "public", "unlisted", "all" ], "type": "string", "description": "public (API default), unlisted or all." }, "start_before": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events starting on/before this date, yyyy-mm-dd." }, "start_phrase": { "enum": [ "today", "yesterday", "tomorrow", "this_week", "this_weekend", "next_week", "next_weekend", "this_month", "next_month" ], "type": "string", "description": "Events starting in a named period (today, this_weekend, next_month...)." }, "created_after": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events created on/after this date, yyyy-mm-dd." }, "inactive_only": { "type": "boolean", "description": "Only inactive events (the API default is false)." }, "created_before": { "type": "string", "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$", "description": "Events created on/before this date, yyyy-mm-dd." }, "organization_id": { "type": "string", "maxLength": 100, "minLength": 1, "description": "Only events of this organization." }, "include_performers": { "type": "boolean", "description": "Include the performers of each event." } } }

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "event_id" ], "properties": { "q": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Exact buyer email address or last name." }, "page": { "type": "integer", "maximum": 100000, "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.", "exclusiveMinimum": 0 }, "sort_by": { "enum": [ "date", "name" ], "type": "string", "description": "Sort field (default date)." }, "event_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "Event id (UUID) from ticketsauce_list_events." }, "per_page": { "type": "integer", "maximum": 500, "description": "Orders per page, 1-500 (default 100).", "exclusiveMinimum": 0 }, "sort_dir": { "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction (default asc)." }, "total_above": { "type": "number", "minimum": 0, "description": "Only orders with a total greater than this." }, "total_below": { "type": "number", "minimum": 0, "description": "Only orders with a total less than this." }, "ordered_after": { "type": "string", "description": "Ordered on/after (UTC)." }, "modified_after": { "type": "string", "description": "Modified on/after (UTC)." }, "ordered_before": { "type": "string", "description": "Ordered on/before (UTC)." }, "ordered_phrase": { "enum": [ "today", "yesterday", "tomorrow", "this_week", "this_weekend", "next_week", "next_weekend", "this_month", "next_month" ], "type": "string", "description": "Ordered in a named period." }, "return_tickets": { "type": "boolean", "description": "Include each order's tickets." }, "modified_before": { "type": "string", "description": "Modified on/before (UTC)." }, "promo_used_only": { "type": "boolean", "description": "Only orders that used a promo code." }, "return_line_item_fees": { "type": "boolean", "description": "Include line-item fees." }, "return_questionnaires": { "type": "boolean", "description": "Include questionnaire answers." } } }