Skiddle API and MCP server Let your AI agent run your Skiddle events.

ToolWhat it doesAccess

• list_events Your events with date, status and tickets sold. read

  Lists the events on the Promotion Centre dashboard, soonest first. By default it returns active upcoming events; status switches to past, draft, embargoed, deleted or suspended events, the same filter as the dashboard. Each row carries the event_id the other tools take. Use get_event for the full listing.

  MCP callskiddle_read → list_events

  REST endpointGET https://cotlet.dev/api/v1/skiddle/events

  Parameters

  Parameters: list_events

  Name	Type	Description
  status string	string	upcoming, past, draft, embargoed, deleted or suspended. Default upcoming.
  query string	string	Full event name or a keyword from it.

  Example response

  {
    "events": [
      {
        "event_id": "5821140",
        "name": "Warehouse Sessions",
        "starts_at": "2026-11-14T22:00:00+00:00",
        "status": "live",
        "visibility": "public",
        "tickets_sold": 412
      },
      {
        "event_id": "5821377",
        "name": "Rooftop Social",
        "starts_at": "2026-11-21T19:00:00+00:00",
        "status": "live",
        "visibility": "public",
        "tickets_sold": 198
      }
    ]
  }

• get_event One event with venue, visibility and ticket totals. read

  Returns the listing of one event: name, venue, date, public or private visibility, the embargo time if one is set, and totals for tickets sold and on sale. Use list_tickets for the individual tickets.

  MCP callskiddle_read → get_event

  REST endpointGET https://cotlet.dev/api/v1/skiddle/events/{event_id}

  Parameters

  Parameters: get_event

  Name	Type	Description
  event_id string required	string	Event ID from list_events.

  Example input

  {
    "event_id": "event_8c41d2"
  }

  Example response

  {
    "event_id": "5821140",
    "name": "Warehouse Sessions",
    "venue": "The Foundry, Leeds",
    "starts_at": "2026-11-14T22:00:00+00:00",
    "visibility": "public",
    "embargo_until": null,
    "tickets_sold": 412,
    "tickets_on_sale": 150
  }

• list_tickets The tickets of an event with price, allocation and sales state. read

  Lists what Manage Tickets > View Tickets shows: each ticket with price, allocation, how many are sold and whether it is on sale or closed. Guestlist tickets are included and marked, because they are hidden from the public listing. Take the ticket_id from here.

  MCP callskiddle_read → list_tickets

  REST endpointGET https://cotlet.dev/api/v1/skiddle/events/{event_id}/tickets

  Parameters

  Parameters: list_tickets

  Name	Type	Description
  event_id string required	string	Event ID from list_events.

  Example input

  {
    "event_id": "event_8c41d2"
  }

  Example response

  {
    "tickets": [
      {
        "ticket_id": "90113",
        "name": "Early Bird",
        "price": 12,
        "allocation": 150,
        "sold": 150,
        "state": "closed",
        "guestlist": false
      },
      {
        "ticket_id": "90114",
        "name": "General Release",
        "price": 15,
        "allocation": 300,
        "sold": 262,
        "state": "on_sale",
        "guestlist": false
      },
      {
        "ticket_id": "90120",
        "name": "Artist Guestlist",
        "price": 0,
        "allocation": 40,
        "sold": 6,
        "state": "on_sale",
        "guestlist": true
      }
    ]
  }

• set_ticket_allocation Set how many tickets of a type can be sold. write

  Changes the allocation of one ticket while the event is on sale, the pencil icon in the Allocation column. The new number shows on the event listing at once. It reaches no customer and you can set the old number back, so it does not ask for confirmation by default. Price cannot be changed this way, and Skiddle blocks a price change once a ticket has sold.

  MCP callskiddle_write → set_ticket_allocation

  REST endpointPUT https://cotlet.dev/api/v1/skiddle/tickets/{ticket_id}/allocation

  Parameters

  Parameters: set_ticket_allocation

  Name	Type	Description
  ticket_id string required	string	Ticket ID from list_tickets.
  allocation integer required	integer	New number of tickets available in total.

  Example input

  {
    "ticket_id": "ticket_8c41d2",
    "allocation": 1
  }

  Example response

  {
    "ticket_id": "90114",
    "name": "General Release",
    "allocation": 350,
    "sold": 262
  }

• close_ticket Take a ticket off sale. write

  Closes one ticket, so customers cannot buy it any more, like the Close option under the cog in View Tickets. It sends nothing to anyone and reopen_ticket puts it back on sale, so it does not ask for confirmation by default. Close all tickets before downloading a final customer list, so no late order is missed.

  MCP callskiddle_write → close_ticket

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/tickets/{ticket_id}/close

  Parameters

  Parameters: close_ticket

  Name	Type	Description
  ticket_id string required	string	Ticket ID from list_tickets.

  Example input

  {
    "ticket_id": "ticket_8c41d2"
  }

  Example response

  {
    "ticket_id": "90114",
    "name": "General Release",
    "state": "closed"
  }

• reopen_ticket Put a closed ticket back on sale. write

  Reopens a closed ticket, like Reopen under the cog in View Tickets. Skiddle asks when it should stop selling again: by default one hour before the event starts, or at a date and time you give in closes_at. It sends nothing to anyone and close_ticket undoes it, so it does not ask for confirmation by default.

  MCP callskiddle_write → reopen_ticket

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/tickets/{ticket_id}/reopen

  Parameters

  Parameters: reopen_ticket

  Name	Type	Description
  ticket_id string required	string	Ticket ID from list_tickets.
  closes_at string	string	When sales stop again, ISO 8601. Default: 1 hour before the event starts.

  Example input

  {
    "ticket_id": "ticket_8c41d2"
  }

  Example response

  {
    "ticket_id": "90114",
    "name": "General Release",
    "state": "on_sale",
    "closes_at": "2026-11-14T21:00:00+00:00"
  }

• copy_event Create a new event from an existing listing. write

  Does Manage Event > Copy Event: most details of the original are copied, and tickets are not, so add them afterwards. You still change the date, venue, artists and images. visibility is private unless you say public, so the copy does not appear on the Skiddle events guide until you decide. Nothing is sent to anyone, and the copy can be deleted in the app, so it does not ask for confirmation by default.

  MCP callskiddle_write → copy_event

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/events/{event_id}/copy

  Parameters

  Parameters: copy_event

  Name	Type	Description
  event_id string required	string	Event ID from list_events.
  starts_at string required	string	Start of the new event, ISO 8601.
  visibility string	string	private or public. Default private.

  Example input

  {
    "event_id": "event_8c41d2",
    "starts_at": "starts at"
  }

  Example response

  {
    "event_id": "5822004",
    "copied_from": "5821140",
    "name": "Warehouse Sessions",
    "starts_at": "2026-11-28T22:00:00+00:00",
    "visibility": "private",
    "tickets_copied": false
  }

ToolWhat it doesAccess

• list_orders Orders of an event, found by name, email, postcode or order ID. read

  Runs the Order Admin search for one event, which matches customer name, email address, postcode or order ID. Each row shows the buyer, the tickets and the total. The rows carry customer contact details, so use them only for messages about the event, as Skiddle requires.

  MCP callskiddle_read → list_orders

  REST endpointGET https://cotlet.dev/api/v1/skiddle/events/{event_id}/orders

  Parameters

  Parameters: list_orders

  Name	Type	Description
  event_id string required	string	Event ID from list_events.
  query string	string	Name, email address, postcode or order ID. An order ID needs its hyphens.

  Example input

  {
    "event_id": "event_8c41d2"
  }

  Example response

  {
    "orders": [
      {
        "order_id": "48213-77120",
        "customer": "Maria Jensen",
        "email": "maria.jensen@example.com",
        "tickets": 2,
        "total": 30,
        "placed_at": "2026-10-22T18:41:00+01:00"
      }
    ]
  }

• get_order One order with its tickets, customer details and refund state. read

  Opens the order page of Order Admin: order date and time, the customer, each ticket with its cost and whether it was already refunded. Read it before refund_order to pick the right ticket.

  MCP callskiddle_read → get_order

  REST endpointGET https://cotlet.dev/api/v1/skiddle/orders/{order_id}

  Parameters

  Parameters: get_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders, with the hyphens as shown in Order Admin.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "48213-77120",
    "placed_at": "2026-10-22T18:41:00+01:00",
    "customer": "Maria Jensen",
    "email": "maria.jensen@example.com",
    "tickets": [
      {
        "ticket_id": "90114",
        "name": "General Release",
        "price": 15,
        "refunded": false
      },
      {
        "ticket_id": "90114",
        "name": "General Release",
        "price": 15,
        "refunded": false
      }
    ]
  }

• refund_order Refund a whole order or one ticket of it. writeasks first

  Refunds through Order Admin, as the Refund options on the order page do. Without ticket_id the whole order is refunded; with it, one ticket. Use it for single customers; cancelling or postponing the whole event has its own procedure in Skiddle and is not a tool. By default you confirm each call; you can switch that off for this tool.

  MCP callskiddle_write → refund_order

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/orders/{order_id}/refund

  Parameters

  Parameters: refund_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders, with the hyphens as shown in Order Admin.
  ticket_id string	string	Refund only this ticket of the order. Default: the whole order.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "48213-77120",
    "scope": "ticket",
    "ticket_id": "90114",
    "status": "refunded",
    "amount": 15
  }

• resend_order_receipt Email the ticket receipt of an order to the customer again. writeasks first

  Uses the Resend ticket receipts action on the order page of Order Admin. The receipt goes to the address on the order. By default you confirm each call; you can switch that off for this tool.

  MCP callskiddle_write → resend_order_receipt

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/orders/{order_id}/receipt/resend

  Parameters

  Parameters: resend_order_receipt

  Name	Type	Description
  order_id string required	string	Order ID from list_orders, with the hyphens as shown in Order Admin.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "48213-77120",
    "sent_to": "maria.jensen@example.com",
    "status": "sent"
  }

ToolWhat it doesAccess

• add_to_guestlist Issue free guestlist tickets to a guest by email. writeasks first

  Does what Guestlist Manager > Add to Guestlist and Send Tickets does: the guest gets the number of tickets you give, of a guestlist ticket type, by email. Guestlist tickets are hidden from the public listing. The ticket type must exist already; list_tickets shows it with guestlist true. By default you confirm each call; you can switch that off for this tool.

  MCP callskiddle_write → add_to_guestlist

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/events/{event_id}/guestlists

  Parameters

  Parameters: add_to_guestlist

  Name	Type	Description
  event_id string required	string	Event ID from list_events.
  ticket_id string required	string	A guestlist ticket ID from list_tickets.
  name string required	string	Guest name.
  email string required	string	Address that receives the tickets.
  quantity integer	integer	Tickets to issue. Default 1.

  Example input

  {
    "event_id": "5821140",
    "ticket_id": "90120",
    "name": "Tom Berg",
    "email": "tom.berg@example.com",
    "quantity": 2
  }

  Example response

  {
    "event_id": "5821140",
    "ticket_id": "90120",
    "name": "Tom Berg",
    "email": "tom.berg@example.com",
    "quantity": 2,
    "status": "sent"
  }

• create_discount_code Create a promotion with one or more discount codes. write

  Creates a promotion under Manage Tickets > Discount Codes: a percentage or fixed amount, the eligible tickets, a usage limit per code (or unlimited), and either the codes you name or a number to generate. A customer can use one code per order. Nothing is sent to anyone, and the codes can be deactivated in the app, so it does not ask for confirmation by default.

  MCP callskiddle_write → create_discount_code

  REST endpointPOST https://cotlet.dev/api/v1/skiddle/events/{event_id}/discount-codes

  Parameters

  Parameters: create_discount_code

  Name	Type	Description
  event_id string required	string	Event ID from list_events.
  name string required	string	Promotion name.
  type string required	string	percentage or fixed.
  value number required	number	Percent off, or the amount off in the event currency.
  ticket_ids array	array	Eligible tickets. Default: all tickets on sale.
  codes array	array	Codes to create, one per entry. Leave out to use generate.
  generate integer	integer	Number of codes to generate when codes is empty.
  uses_per_code integer	integer	Uses per code. Default unlimited.

  Example input

  {
    "event_id": "event_8c41d2",
    "name": "Jane Doe",
    "type": "type",
    "value": 1
  }

  Example response

  {
    "promotion": "Last week 20%",
    "type": "percentage",
    "value": 20,
    "codes": [
      "LASTWEEK20"
    ],
    "uses_per_code": 100,
    "status": "active"
  }

• list_discount_codes Promotions and their discount codes with usage. read

  Lists the promotions of an event from Manage Tickets > Discount Codes: discount type, eligible tickets and each code with its uses and limit. Usage is counted per order, not per ticket.

  MCP callskiddle_read → list_discount_codes

  REST endpointGET https://cotlet.dev/api/v1/skiddle/events/{event_id}/discount-codes

  Parameters

  Parameters: list_discount_codes

  Name	Type	Description
  event_id string required	string	Event ID from list_events.

  Example input

  {
    "event_id": "event_8c41d2"
  }

  Example response

  {
    "promotions": [
      {
        "promotion": "Last week 20%",
        "type": "percentage",
        "value": 20,
        "codes": [
          {
            "code": "LASTWEEK20",
            "used": 14,
            "limit": 100
          }
        ]
      }
    ]
  }

• get_ticket_sales Ticket sales for chosen events within a date range. read

  Returns the Analytics > Ticket Stats > Ticket Sales report. By default it covers future events with sales in the last 14 days; choose events and a range to change that. Values are ticket face value, without booking fees, so they can differ from your Order History.

  MCP callskiddle_read → get_ticket_sales

  REST endpointGET https://cotlet.dev/api/v1/skiddle/ticket-sales

  Parameters

  Parameters: get_ticket_sales

  Name	Type	Description
  event_ids array	array	Event IDs to include. Default: future events with recent sales.
  from string	string	Start of the sales period, YYYY-MM-DD.
  to string	string	End of the sales period, YYYY-MM-DD.

  Example response

  {
    "period": {
      "from": "2026-10-17",
      "to": "2026-10-31"
    },
    "events": [
      {
        "event_id": "5821140",
        "name": "Warehouse Sessions",
        "tickets": 118,
        "face_value": 1647
      },
      {
        "event_id": "5821377",
        "name": "Rooftop Social",
        "tickets": 44,
        "face_value": 528
      }
    ]
  }