Ticketsauce MCP by usefulapi

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.

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

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}.

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

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}.

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

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}.

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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}.

{
  "type": "object",
  "properties": {
    "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."
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per_page": {
      "description": "Ids per page, 1-5000 (default 1000).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 5000
    }
  },
  "required": [
    "event_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}