The Ticket Tailor MCP connector routes your AI agent's tool calls to Ticket Tailor's own MCP server through Scalekit. Each user signs in to Ticket Tailor once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 65 tools.
- Tools
- 65
- What they doRead · write · destructive
- 21 · 13 · 3121 read13 write31 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Ticket Tailor MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Ticket Tailor MCP connection
In AgentKit > Connections, create a Ticket Tailor MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Ticket Tailor MCP server connections use your own OAuth app. Register one with Ticket Tailor MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Ticket Tailor MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'tickettailormcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Ticket Tailor MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'tickettailormcp_check_ins_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "tickettailormcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Ticket Tailor MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="tickettailormcp_check_ins_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooltickettailormcp_check_ins_getReturns a list of check-ins.Read-onlyGet list of check-ins
Returns a list of check-ins.
Inputs
checked_in_atnumber- Unix timestamp that returns items with matched check_in_at value.
checked_in_at_gtnumber- Unix timestamp that returns items with check_in_at greater than the value.
checked_in_at_gtenumber- Unix timestamp that returns items with check_in_at greater than or equal to the value.
checked_in_at_ltnumber- Unix timestamp that returns items with check_in_at less than the value.
checked_in_at_ltenumber- Unix timestamp that returns items with check_in_at less than or equal to the value.
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idstring- The event ID of the check-in. Must have the prefix 'ev_'
event_series_idstring- The event series ID of the check-in. Must have the prefix 'es_'
issued_ticket_idstring- The issued ticket ID of the check-in. Must have the prefix 'it_'
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_checkout_form_elements_getReturns a list of checkout form elements.Read-onlyGet list of checkout form elements
Returns a list of checkout form elements. Pass checkout_form_element_id to get a single checkout form element.
Inputs
checkout_form_idstringrequired- The unique identifier for the checkout form. Must have the prefix 'cf_'
checkout_form_element_idstring- The unique identifier for the checkout form element. Must have the prefix 'cfe_'. Pass it to get that single checkout form element instead of a list; list filters are then ignored.
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_checkout_forms_getReturns a list of checkout forms.Read-onlyGet list of checkout forms
Returns a list of checkout forms.
Inputs
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_discounts_getReturns a list of discounts.Read-onlyGet list of discounts
Returns a list of discounts. Pass discount_id to get a single discount.
Inputs
codestring- The code of the discount
discount_idstring- The unique identifier for the discount. Must have the prefix 'di_'. Pass it to get that single discount instead of a list; list filters are then ignored.
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_event_occurrences_getReturns a list of event occurrences.Read-onlyGet list of event occurrences
Returns a list of event occurrences. Pass event_occurrence_id to get a single event occurrence.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
end_atnumber- Unix timestamp for end at date
end_at_gtnumber- Unix timestamp for end at date greater than
end_at_gtenumber- Unix timestamp for end at date greater than or equal to
end_at_ltnumber- Unix timestamp for end at date less than
end_at_ltenumber- Unix timestamp for end at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_occurrence_idstring- The unique identifier for the event occurrence. Must have the prefix 'ev_'. Pass it to get that single event occurrence instead of a list; list filters are then ignored.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
override_idstring- The unique identifier for the override. Must have the prefix 'ov_'
start_atnumber- Unix timestamp for start at date
start_at_gtnumber- Unix timestamp for start at date greater than
start_at_gtenumber- Unix timestamp for start at date greater than or equal to
start_at_ltnumber- Unix timestamp for start at date less than
start_at_ltenumber- Unix timestamp for start at date less than or equal to
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_event_series_getRetrieves a paginated list of event series from your Ticket Tailor account.Read-onlyGet list of event series
Retrieves a paginated list of event series from your Ticket Tailor account. Event series are collections of related events (like a recurring concert series or festival). Use this to browse, search, and filter your event series by status, name, venue, or creation date. This is a read-only operation that returns metadata about your event series without modifying any data. Pass event_series_id to get a single event series.
Inputs
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_series_idstring- The unique identifier for the event series. Must have the prefix 'es_'. Pass it to get that single event series instead of a list; list filters are then ignored.
limitnumber- The maximum number of items to return. Maximum: 100
namestring- Search for event series by name. Performs a partial text match on the series name
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- Filter event series by their publication status. 'draft' shows unpublished series, 'published' shows live series accepting orders, 'sales_closed' shows series that are no longer selling ticketsone of
draftpublishedsales_closed venuestring- Filter event series by venue name. Performs a partial text match on the venue field
tickettailormcp_events_getRetrieves a paginated list of individual event occurrences from your Ticket Tailor account.Read-onlyGet list of events
Retrieves a paginated list of individual event occurrences from your Ticket Tailor account. Events are specific instances within an event series (typically either for time slot admission; or else individual instances of multi-day events like 'Saturday' or 'Sunday' festival tickets, or 'Workshop Session A'). Use this to browse, search, and filter your events by status, name, venue, or date range. This is a read-only operation that returns metadata about your events without modifying any data. Pass event_id to get a single event.
Inputs
end_atnumber- Unix timestamp for end at date
end_at_gtnumber- Unix timestamp for end at date greater than
end_at_gtenumber- Unix timestamp for end at date greater than or equal to
end_at_ltnumber- Unix timestamp for end at date less than
end_at_ltenumber- Unix timestamp for end at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idstring- The unique identifier for the event. Must have the prefix 'ev_'. Pass it to get that single event instead of a list; list filters are then ignored.
limitnumber- The maximum number of items to return. Maximum: 100
namestring- Search for events by name. Performs a partial text match on the event name
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
start_atnumber- Unix timestamp for start at date
start_at_gtnumber- Unix timestamp for start at date greater than
start_at_gtenumber- Unix timestamp for start at date greater than or equal to
start_at_ltnumber- Unix timestamp for start at date less than
start_at_ltenumber- Unix timestamp for start at date less than or equal to
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- Filter events by their publication status. 'draft' shows unpublished events, 'published' shows live events accepting orders, 'sales_closed' shows events that are no longer selling ticketsone of
draftpublishedsales_closed venuestring- Filter events by venue name. Performs a partial text match on the venue field
tickettailormcp_holds_getReturns a list of holds.Read-onlyGet list of holds
Returns a list of holds. Pass hold_id to get a single hold.
Inputs
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idstring- The unique identifier for the event. Must have the prefix 'ev_'
hold_idstring- The unique identifier for the hold. Must have the prefix 'ho_'. Pass it to get that single hold instead of a list; list filters are then ignored.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
updated_atnumber- Unix timestamp for updated at date
updated_at_gtnumber- Unix timestamp for updated at date greater than
updated_at_gtenumber- Unix timestamp for updated at date greater than or equal to
updated_at_ltnumber- Unix timestamp for updated at date less than
updated_at_ltenumber- Unix timestamp for updated at date less than or equal to
tickettailormcp_issued_memberships_getReturns a paginated list of issued memberships.Read-onlyGet list of issued memberships
Returns a paginated list of issued memberships. Pass issued_membership_id to get a single issued membership.
Inputs
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
emailstring- Filter by email (contains)
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
first_namestring- Filter by first name (contains)
issued_membership_codestring- Filter by exact membership code
issued_membership_idstring- The unique identifier for the issued membership. Must have the prefix 'im_'. Pass it to get that single issued membership instead of a list; list filters are then ignored.
last_namestring- Filter by last name (contains)
limitnumber- The maximum number of items to return. Maximum: 100
memberships_statusstring- Filter by membership validity status. 'valid' returns only currently valid memberships, 'invalid' returns expired or voided memberships, 'both' returns all. Defaults to 'valid'one of
validinvalidboth newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
orderstring- Sort direction when order_by is specified. Defaults to 'asc'one of
ascdesc order_bystring- Order results by member's first_name or last_nameone of
first_namelast_name searchstring- Search by first name, last name or email (contains)
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
updated_atnumber- Unix timestamp for updated at date
updated_at_gtnumber- Unix timestamp for updated at date greater than
updated_at_gtenumber- Unix timestamp for updated at date greater than or equal to
updated_at_ltnumber- Unix timestamp for updated at date less than
updated_at_ltenumber- Unix timestamp for updated at date less than or equal to
tickettailormcp_issued_tickets_getReturns a list of issued tickets.Read-onlyGet list of issued tickets
Returns a list of issued tickets. Pass issued_ticket_id to get a single issued ticket.
Inputs
barcodestring- The barcode of the issued ticket
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
emailstring- The email of the person attending an event
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idstring- The unique identifier for the event. Must have the prefix 'ev_'
event_series_idstring- The unique identifier for the event series. Must have the prefix 'es_'
issued_ticket_idstring- The unique identifier for the issued ticket. Must have the prefix 'it_'. Pass it to get that single issued ticket instead of a list; list filters are then ignored.
limitnumber- The maximum number of items to return. Maximum: 100
namestring- The name of the person attending an event
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
order_idstring- The unique identifier for the order. Must have the prefix 'or_'
reference_idstring- The imported reference of the ticket
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- The status of the issued ticketone of
validvoided
tickettailormcp_membership_types_getReturns a paginated list of membership types.Read-onlyGet list of membership types
Returns a paginated list of membership types. Pass membership_type_id to get a single membership type.
Inputs
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
limitnumber- The maximum number of items to return. Maximum: 100
membership_type_idstring- The unique identifier for the membership type. Must have the prefix 'mt_'. Pass it to get that single membership type instead of a list; list filters are then ignored.
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_orders_getRetrieves a paginated list of customer orders from your Ticket Tailor account.Read-onlyGet list of orders
Retrieves a paginated list of customer orders from your Ticket Tailor account. Orders represent completed ticket (and/or product) purchases and contain information about the buyer, items purchased, payment status, and order details. Use this to track sales, analyze customer data, and manage order fulfillment. This is a read-only operation that returns order information without modifying any data. Pass order_id to get a single order.
Inputs
barcodestring- Search for orders containing a specific ticket barcode. Useful for finding orders associated with a particular ticket
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
emailstring- Search for orders by the buyer's email address. Useful for finding all orders from a specific customer, or identifying repeat purchasers.
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idstring- Filter orders by a specific event occurrence. Returns only orders for tickets to this particular event. Must have the prefix 'ev_'
event_series_idstring- Filter orders by a specific event series. Returns all orders for tickets to any event within this series. Must have the prefix 'es_'
limitnumber- The maximum number of items to return. Maximum: 100
namestring- Search for orders by the buyer's full name. Performs a partial text match on the customer name field
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
order_idstring- The unique identifier for the order. Must have the prefix 'or_'. Pass it to get that single order instead of a list; list filters are then ignored.
referral_tagstring- Filter orders by the referral tag that tracks where the sale originated
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- Filter orders by their current status. 'pending' means the order is complete but payment has not been received.one of
completedpendingcanceled store_idstring- Filter orders by a specific store. Must have the prefix 'st_'
txn_idstring- Search for a specific order by its transaction ID. Transaction IDs are unique identifiers for payment processing. These are added automatically to associate the respective transaction if made through Stripe, PayPal, or Square; otherwise they are entered manually.
tickettailormcp_overrides_getReturns a list of overrides.Read-onlyGet list of overrides
Returns a list of overrides.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
reference_idstring- A string representing the referenced ticket typ or ticket group
reference_typestring- A string representing the reference type, either ticket or ticket_group or bundleone of
ticket_typeticket_groupbundle starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- A string representing override statusone of
on_salesold_outunavailablehiddenadmin_onlylocked
tickettailormcp_overview_getRetrieve a comprehensive overview of your Ticket Tailor box office account, including key metrics, account information, and summary statistics.Read-onlyGet account overview
Retrieve a comprehensive overview of your Ticket Tailor box office account, including key metrics, account information, and summary statistics. This provides a high-level dashboard view with data about your events, sales, and account status. Useful for getting a quick snapshot of your business performance and account health. This is a read-only operation that returns account summary information without modifying any data.
Inputs
This tool takes no inputs.
tickettailormcp_ping_getTests connectivity to the Ticket Tailor API server and retrieves version information.Read-onlyPing server
Tests connectivity to the Ticket Tailor API server and retrieves version information. This is a lightweight health check that verifies your API credentials are valid and the service is responding. Useful for troubleshooting connection issues, validating API access, or checking service status. Returns server version details and confirms your authentication is working properly.
Inputs
This tool takes no inputs.
tickettailormcp_products_getReturns a list of products.Read-onlyGet list of products
Returns a list of products. Pass product_id to get a single product.
Inputs
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_series_idstring- The unique identifier for the event series. Must have the prefix 'es_'
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
product_idstring- The unique identifier for the product. Must have the prefix 'pr_'. Pass it to get that single product instead of a list; list filters are then ignored.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
statusstring- The status of the productone of
on_salehiddensold_out updated_atnumber- Unix timestamp for updated at date
updated_at_gtnumber- Unix timestamp for updated at date greater than
updated_at_gtenumber- Unix timestamp for updated at date greater than or equal to
updated_at_ltnumber- Unix timestamp for updated at date less than
updated_at_ltenumber- Unix timestamp for updated at date less than or equal to
tickettailormcp_store_listRetrieves a list of all stores associated with the provided API key.Read-onlyList stores
Retrieves a list of all stores associated with the provided API key. This tool is useful for managing multiple stores within your Ticket Tailor account. It returns a list of store IDs, names, and other relevant details for each store. This is a read-only operation that does not modify any data. Pass storeId to get a single store.
Inputs
storeIdstring- The ID (prefixed with 'st_') of the store to get. Pass it to get that single store instead of a list.
tickettailormcp_voucher_codes_getReturns a list of voucher codes.Read-onlyGet list of voucher codes
Returns a list of voucher codes.
Inputs
voucher_idstringrequired- The unique identifier for the voucher. Must have the prefix 'vo_'
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
expiry_atnumber- Unix timestamp for expiry at date
expiry_at_gtnumber- Unix timestamp for expiry at date greater than
expiry_at_gtenumber- Unix timestamp for expiry at date greater than or equal to
expiry_at_ltnumber- Unix timestamp for expiry at date less than
expiry_at_ltenumber- Unix timestamp for expiry at date less than or equal to
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_vouchers_getReturns a list of vouchers.Read-onlyGet list of vouchers
Returns a list of vouchers. Pass voucher_id to get a single voucher.
Inputs
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
expiry_atnumber- Unix timestamp for expiry at date
expiry_at_gtnumber- Unix timestamp for expiry at date greater than
expiry_at_gtenumber- Unix timestamp for expiry at date greater than or equal to
expiry_at_ltnumber- Unix timestamp for expiry at date less than
expiry_at_ltenumber- Unix timestamp for expiry at date less than or equal to
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
voucher_idstring- The unique identifier for the voucher. Must have the prefix 'vo_'. Pass it to get that single voucher instead of a list; list filters are then ignored.
tickettailormcp_waitlist_signups_getReturns a list of waitlist signups.Read-onlyGet list of waitlist signups
Returns a list of waitlist signups.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
created_atnumber- Unix timestamp for created at date
created_at_gtnumber- Unix timestamp for created at date greater than
created_at_gtenumber- Unix timestamp for created at date greater than or equal to
created_at_ltnumber- Unix timestamp for created at date less than
created_at_ltenumber- Unix timestamp for created at date less than or equal to
emailstring- Used for filtering waitlist signups by email
ending_beforestring- Return items before this ID, i.e. older ones. Pass the ID with its prefix (e.g. 'or_123'). Takes precedence over starting_after.
event_idsstring- Used for filtering waitlist signups by events they belong to. Event id must have the prefix 'ev_'
is_notifiedboolean- Used for filtering notified waitlist signups
limitnumber- The maximum number of items to return. Maximum: 100
newest_firstboolean- Return the most recent items first. Items are returned oldest first by default. For the next page of older items, keep newest_first and pass the ID of the last item as ending_before.
starting_afterstring- Return items after this ID, i.e. newer ones. Pass the ID of the last item on the previous page, with its prefix (e.g. 'or_123').
tickettailormcp_bundle_createCreates a new bundle in event series.WriteCreate event series bundle
Creates a new bundle in event series.
Inputs
descriptionstringrequired- Description of the bundle
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
namestringrequired- Name of the bundle
priceintegerrequired- Price of the bundle in cents
ticket_typesarrayrequired- List of ticket type IDs included in the bundle. Ticket type id must have the prefix 'tt_'
access_codestring- Code to access a protected bundle
booking_feeinteger- Booking fee which is charged per bundle to the customer and the funds are paid to you. We would recommend charging no more than 10% of the bundle price.
product_idsarray- List of product IDs included in the bundle. Product id must have the prefix 'pr_'
statusstring- Bundle statusone of
ADMIN_ONLYHIDDENLOCKEDSOLD_OUTON_SALEUNAVAILABLE
tickettailormcp_check_in_createCreates a check-in or check-out record for an issued ticket.WriteCreate check-in
Creates a check-in or check-out record for an issued ticket. Check-ins track when attendees arrive at or leave an event. This is essential for event management, attendance tracking, and security. You can check in attendees at the door, track early departures, or manage re-entry. The system prevents duplicate check-ins unless explicitly allowed. These records stack up, so the current check-in state of an issued ticket is the sum of its corresponding records.
Inputs
issued_ticket_idstringrequired- The unique identifier of the issued ticket to check in or check out. This is the ticket that will be marked as attended or left. Must have the prefix 'it_'
quantitynumberrequired- The check-in action: 1 for check-in (attendee arriving), -1 for check-out (attendee leaving). Use 1 to mark attendance, -1 to record early departure or re-entry
check_in_atinteger- Unix timestamp (in seconds) when the check-in occurred. If not provided, the current time will be used. Useful for backdating check-ins or bulk imports
local_unique_idstring- A unique identifier to prevent duplicate check-ins when retrying failed operations. If not provided, Ticket Tailor will generate one automatically. Essential for reliable check-in systems
tickettailormcp_discount_createCreates a discount code that customers can use during checkout to receive reduced pricing.WriteCreate discount code
Creates a discount code that customers can use during checkout to receive reduced pricing. Discount codes are powerful marketing tools that can increase sales, reward loyal customers, or fill seats. You can create percentage-based or fixed-amount discounts, set usage limits, and restrict them to specific ticket types or products. The discount code will be immediately available for customers to use.
Inputs
codestringrequired- The actual discount code that customers will enter at checkout (e.g., 'EARLYBIRD', 'STUDENT20', 'HOLIDAY50'). Should be memorable and easy to type and preferably unique
namestringrequired- A descriptive name for the discount code (e.g., 'Early Bird Discount', 'Student Discount', 'Holiday Special'). This is for internal reference and appears in your admin dashboard
typestringrequired- The type of discount: 'fixed_amount' reduces the item price by a specific amount, 'percentage' reduces the price by a percentage of the original costone of
fixed_amountpercentage booking_feeinteger- Fixed amount to reduce the booking fee by, in cents (e.g., 500 = $5.00 off booking fee). Can be used with either discount type
booking_fee_percentinteger- Percentage to reduce the booking fee by (e.g., 50 = 50% off booking fee). Can be used with either discount type
expiresinteger- Unix timestamp (in seconds) when the discount code expires. After this date, the code will no longer be valid. Leave empty for no expiration
max_redemptionsinteger- Maximum number of times this discount code can be used across all customers. Once reached, the code becomes invalid. Leave empty for unlimited usage
max_ticketsinteger- Maximum number of tickets in a single order that can use this discount code. Prevents abuse of bulk discounts
min_ticketsinteger- Minimum number of tickets that must be purchased in a single order to use this discount code. Useful for encouraging larger purchases
priceinteger- For fixed_amount discounts, the amount to subtract from the item price in cents (e.g., 1000 = $10.00 off). Required when type is 'fixed_amount'
price_percentinteger- For percentage discounts, the percentage to reduce the item price by (e.g., 20 = 20% off). Required when type is 'percentage'
productsarray- Array of product IDs where this discount can be applied. If empty, the discount applies to all products. Product id must have the prefix 'pr_'
ticket_typesarray- Array of ticket type IDs where this discount can be applied. If empty, the discount applies to all ticket types. Ticket type id must have the prefix 'tt_'
tickettailormcp_event_management<usecases> Create multiple events with single tool call.WriteCreate event series
<usecases> Create multiple events with single tool call. Create one or more event series. Create one or more event occurrences for one or more new event series. Create one or more event occurrences for one or more existing event series. Create one or more ticket types for one or more new event series. Create one or more ticket types for one or more existing event series. Create one or more ticket groups for one or more new event series. Create one or more ticket groups for one or more existing event series. </usecases> <instructions> Pass event series related data in eventSeries array to create event series. Pass event occurrences related data in eventOccurrences array to create event occurrences. Pass ticket types related data in ticketTypes array to create ticket types. Pass ticket groups related data in ticketGroups array to create ticket groups. When creating multiple event series with multiple event occurrences and/or multiple ticket types and or multiple ticket groups, use a placeholder for event_series_id in eventOccurrences and ticketTypes and ticketGroups arrays. Placeholder must have a structure of es_placeholder1, es_placeholder2, etc. where the number is the index of the previously created event series. When creating ticket groups and referencing a ticket type that is to be created in the same call, use a placeholder for ticket_type_ids in ticketGroups array. Placeholder must have a structure of tt_placeholder1, tt_placeholder2, etc. where the number is the index of the previously created ticket type. When creating event occurrences or ticket types or ticket groups for an existing event series, use the id of the event series in the event_series_id field. Try to find existing event series first before creating a new one (by name or venue), unless user is explicitly asking to create a new event series. Do not use this tool to update or delete event series, event occurrences or ticket types or ticket groups. Use separate tools for that. </instructions> <validations> Event occurrence end datetime must be after start datetime. Ticket group can not contain bundle_ids when ticket group has max_quantity, max_per_order or min_per_order populated. </validations>
Inputs
eventOccurrencesarrayrequired- Array of event occurrence objects (dates and times) to create for the series.
eventSeriesarrayrequired- Array of event series objects to create (one entry per series).
ticketGroupsarrayrequired- Array of ticket group objects to create for the series.
ticketTypesarrayrequired- Array of ticket type objects to create for the series.
tickettailormcp_event_series_duplicate<usecases> Copy an existing event series one or more times, the same as Duplicate in the dashboard.WriteDuplicate event series
<usecases> Copy an existing event series one or more times, the same as Duplicate in the dashboard. Bulk create events (e.g. a tour across many venues) from one event series the user has set up as a template. </usecases> <instructions> Each copy keeps the source's images, description, venue, ticket types, ticket groups, bundles, checkout questions and settings. This is the only way to give new event series an image through this server. Event occurrences (dates) are not copied. Each copy starts in DRAFT status with the same name as the source. After duplicating: use event_series_update to change each copy's name, venue or postal code; use event_management with the copy's event_series_id to add event occurrences; then use event_series_status_change to publish. Find the source event series first (by name or venue) and confirm it with the user before making many copies. </instructions>
Inputs
event_series_idstringrequired- The unique identifier of the event series to copy. Must have the prefix 'es_'
copiesinteger- How many copies to make. Defaults to 1. Maximum 50 per call
tickettailormcp_hold_createCreates a new hold.WriteCreate hold
Creates a new hold.
Inputs
event_idstringrequired- The ID of the associated event for which to create the hold. Must have the prefix 'ev_'
notestringrequired- A string that gives more information about the created hold
ticket_type_idarrayrequired- List of ticket types and their quantities
tickettailormcp_issued_membership_createCreates a new issued membership for a membership type.WriteCreate issued membership
Creates a new issued membership for a membership type. An issued membership represents an actual membership given to a person.
Inputs
emailstringrequired- Email address of the member
first_namestringrequired- First name of the member
last_namestringrequired- Last name of the member
membership_type_idstringrequired- The ID of the membership type. Must have the prefix 'mt_'
max_redemptionsstring- Maximum number of times the issued membership can be redeemed. If not provided, the membership type's default is used. Provide empty string to set unlimited redemptions
valid_from_dateinteger- Unix timestamp (UTC) for when the issued membership becomes valid. Required if valid_from_type is 'fixed'. When not provided, the membership type's default is used
valid_from_typestring- Type of valid from date. 'fixed' uses valid_from_date, 'relative' uses the date of issue. When not provided, the membership type's default is usedone of
fixedrelative valid_to_dateinteger- Unix timestamp (UTC) for when the membership expires. Required if valid_to_type is 'fixed'. When not provided, the membership type's default is used
valid_to_interval_daysinteger- Number of days the membership is valid for from the issue date. Used when valid_to_type is 'relative'. Must be between 1 and 365. When not provided, the membership type's default is used
valid_to_typestring- Type of valid to date. 'fixed' uses valid_to_date, 'relative' uses valid_to_interval_days from issue date. When not provided, the membership type's default is usedone of
fixedrelative
tickettailormcp_issued_membership_redemption_createCreates a redemption for an issued membership at a specific event.WriteCreate issued membership redemption
Creates a redemption for an issued membership at a specific event. This records that the issued membership was used for entry to the event.
Inputs
codestringrequired- The issued membership code to redeem (e.g., 'MMABC123')
event_idstringrequired- The unique identifier for the event. Must have the prefix 'ev_'
tickettailormcp_issued_ticket_createCreates a new issued ticket for an event occurrence from available inventory.WriteCreate issued ticket
Creates a new issued ticket for an event occurrence from available inventory. Issued tickets represent actual tickets that have been allocated to a specific person and can be used for entry. This tool can create tickets from either existing ticket type inventory or from a hold (reserved tickets). The created ticket will be immediately available for check-in and will be included in ticket counts. Ticket Tailor fees apply to issued tickets created via the Ticket Tailor API, irrespective of whether those tickets are free or paid-for.
Inputs
full_namestringrequired- The full name of the person who will attend the event. This name appears on the ticket and is used for check-in verification. Should match the attendee's identification
barcodestring- A custom barcode for the ticket. If not provided, Ticket Tailor will generate a unique barcode automatically. Useful for integrating with external systems. This barcode is rendered as a QR code and 1D barcode on the ticket.
emailstring- The email address of the ticket holder. If provided and send_email is true, Ticket Tailor will attempt to automatically send the ticket and event information to this email. The following conditions must be met for the email to be dispatched: (1) a valid email must be provided in the request payload; (2) the box office must be configured to use separate event confirmation emails and order confirmation emails; (3) the event series to which the event belongs must be approved by Ticket Tailor staff.
event_idstring- The unique identifier of the specific event occurrence. Required when creating tickets from ticket type inventory. Use this to specify which event the ticket is for. Must have the prefix 'ev_'
hold_idstring- The unique identifier of a hold (reserved tickets). Required when creating tickets from a hold. The ticket will be created from the reserved inventory in this hold. Hold id must have the prefix 'ho_'
referencestring- An external reference number or identifier for this ticket. Useful for linking tickets to orders in external systems or for internal tracking purposes
send_emailboolean- When set to true, Ticket Tailor will attempt to automatically send an email to the attendee containing their ticket and event details. The following conditions must be met for the email to be dispatched: (1) a valid email must be provided in the request payload; (2) the box office must be configured to use separate event confirmation emails and order confirmation emails; (3) the event series to which the event belongs must be approved by Ticket Tailor staff.
ticket_type_idstring- The unique identifier of the ticket type to create the ticket from. Required when creating from ticket type inventory. Determines the ticket category and pricing. Ticket type id must have the prefix 'tt_'
tickettailormcp_membership_type_createCreates a new membership type.WriteCreate membership type
Creates a new membership type. Membership types define the configuration for issued memberships including validity periods, redemption limits, and whether photos are required.
Inputs
namestringrequired- Name of the membership type (e.g., 'Annual Pass', 'Monthly Subscription')
valid_from_typestringrequired- Type of valid from date. 'fixed' uses valid_from_date for all issued memberships, 'relative' uses the date of issueone of
fixedrelative valid_to_typestringrequired- Type of valid to date. 'fixed' uses valid_to_date, 'relative' uses valid_to_interval_days from issue dateone of
fixedrelative conditions_and_benefitsarray- Array of conditions and benefits for this membership type (e.g., ['Free entry to all events', '10% discount on merchandise'])
max_redemptionsstring- Maximum number of times memberships of this type can be redeemed. If not provided, redemptions are unlimited
photo_requiredstring- Whether a photo is required when issuing memberships of this typeone of
truefalse valid_from_dateinteger- Unix timestamp (UTC) for when memberships of this type become valid. Required if valid_from_type is 'fixed'
valid_to_dateinteger- Unix timestamp (UTC) for when memberships of this type expire. Required if valid_to_type is 'fixed'
valid_to_interval_daysinteger- Number of days the membership is valid for from the issue date. Required if valid_to_type is 'relative'. Must be between 1 and 365
tickettailormcp_override_createCreates a new override for event series.WriteCreate event series override
Creates a new override for event series.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
namestringrequired- Name of the override
override_linesarrayrequired- An array of associated ticket types (prefix id with 'tt_'), ticket groups (prefix id with 'tg_') or bundles (prefix id with 'bu_').
max_sellable_ticketsinteger- Maximum number of sellable tickets
tickettailormcp_product_createCreates a new product that can be sold alongside tickets.WriteCreate product
Creates a new product that can be sold alongside tickets. Products are additional items like merchandise, parking passes, meal vouchers, or special add-ons that customers can purchase during the ticket buying process. Products can be linked to specific event series or made available across all events, or sold via a standalone store (not yet available through the API). They can have their own pricing, inventory limits, and delivery instructions.
Inputs
namestringrequired- The name of the product that customers will see (e.g., 'Event T-Shirt', 'Parking Pass', 'VIP Dinner Package', 'Program Book'). Should be clear and descriptive
priceintegerrequired- The price of the product in cents (e.g., 1500 = $15.00). This is the base price before any booking fees are applied
booking_feeinteger- Additional fee charged per product, in cents (e.g., 200 = $2.00). This fee is paid to you and helps cover processing costs. Recommended to keep under 10% of product price
currencystring- The currency for this product's pricing. If not specified, defaults to your box office currency. Useful for international events with multiple currenciesone of
gbpusdeuraudbrlcadczkdkkhkdhufilsmyrmxnnoknzdphpplnsgdrubsekchfthbtryaedallamdangawgaznbambbdbdtbgnbmdbndbsdbwpbzdcdfcnydopdzdegpetbfjdgelgipgmdgydhtgidrinrjmdkeskgskhrkydkztlbplkrlrdlslmadmdlmkdmmkmntmopmvrmwkmznnadngnnprpgkpkrqarronrsdsarsbdscrslesosszltjstopttdtzsuahuzswstxcdyerzarzmw descriptionstring- Detailed description of the product including features, specifications, or what's included. Helps customers understand what they're purchasing
event_series_idsarray- Array of event series IDs where this product will be available for purchase. If empty and linked_to_all_event_series is false, product won't be available anywhere unless you have set the product to be sold via a standalone store (not yet available through the API). Event series id must have the prefix 'es_'
instructionsstring- Instructions for customers on how to collect or use the product (e.g., 'Collect at venue entrance', 'Email will be sent with download link', 'Present voucher at restaurant')
issue_ticket_voucherboolean- When true, a QR code voucher will be generated for this product that customers can present for redemption. Useful for digital products or items requiring verification. Mutually exclusive with voucher_id and membership_type_id.
linked_to_all_event_seriesboolean- When true, this product will be available for purchase at all event series. Overrides event_series_ids restrictions
membership_type_idstring- The ID of a membership type to associate with the product. Must start with 'mt_' prefix. Mutually exclusive with issue_ticket_voucher and voucher_id.
quantityinteger- Total quantity of this product available for sale across all events. Once sold out, no more can be purchased. Leave empty for unlimited inventory
quantity_per_eventinteger- Maximum quantity of this product that can be purchased per individual event. Useful for limiting per-event availability
statusstring- Current status of the product. 'ON_SALE' = available for purchase, 'SOLD_OUT' = no inventory, 'HIDDEN' = not visible to customersone of
ON_SALESOLD_OUTHIDDEN voucher_idstring- The ID of a voucher of type gift card to associate with the product. Must start with 'vo_' prefix. Mutually exclusive with issue_ticket_voucher and membership_type_id.
tickettailormcp_voucher_createCreates a new voucher system with associated voucher codes.WriteCreate voucher
Creates a new voucher system with associated voucher codes. Vouchers are flexible promotional tools that can be used as either promotional codes (for marketing campaigns), or gift vouchers (for customer gifting), or as credit in lieu of a payment refund. Promotional vouchers have predefined codes, while gift vouchers and credit vouchers generate unique codes when issued. Vouchers can be restricted to specific event series and have configurable expiration dates and redemption rules.
Inputs
expiryintegerrequired- Unix timestamp (in seconds) when all vouchers in this system expire. After this date, no vouchers can be redeemed. Set far in the future for long-term campaigns
namestringrequired- A descriptive name for the voucher system (e.g., 'Summer Sale Vouchers', 'Gift Cards', 'Loyalty Rewards'). This appears in your admin dashboard for easy identification
valueintegerrequired- The monetary value of each voucher in cents (e.g., 1000 = $10.00). This is the amount that will be deducted from the order total when the voucher is redeemed
codesarray- For PROMO type vouchers, provide an array of specific voucher codes (e.g., ['SUMMER20', 'WELCOME10']). These codes will be available for customers to use. Leave empty for gift vouchers and credit vouchers which generate unique codes automatically
event_series_idsarray- Array of event series IDs where these vouchers can be used. If empty, vouchers can be used on any event series. Useful for targeted promotions. Event series id must have the prefix 'es_'
intervalstring- For GIFT_CARD type vouchers, the number of days from issue date when the gift card expires. 30 = 1 month, 90 = 3 months, 365 = 1 yearone of
3090365 partial_redemptionboolean- When true, customers can use a voucher multiple times until its full value is consumed. When false, the voucher must be used in a single transaction and any unused balance will be lost
voucher_typestring- The type of voucher system: 'PROMO' for marketing campaigns with predefined codes, 'GIFT_CARD' for gift vouchers or credit vouchers with unique generated codes. Defaults to 'PROMO' if not specifiedone of
PROMOGIFT_CARD
tickettailormcp_bundle_deleteDelete a bundle.DestructiveDelete bundle
Delete a bundle. This action is irreversible. The bundle will be permanently removed.
Inputs
bundle_idstringrequired- The unique identifier for the bundle to delete. Must have the prefix 'bu_'
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
tickettailormcp_bundle_updateUpdates an existing bundle in event series.DestructiveUpdate an existing event series bundle
Updates an existing bundle in event series.
Inputs
bundle_idstringrequired- The unique identifier for the bundle to update. Must have the prefix 'bu_'
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
access_codestring- Code to access a protected bundle
booking_feeinteger- Booking fee which is charged per bundle to the customer and the funds are paid to you. We would recommend charging no more than 10% of the bundle price.
descriptionstring- Description of the bundle
namestring- Name of the bundle
priceinteger- Price of the bundle in cents
product_idsarray- List of product IDs included in the bundle. Product id must have the prefix 'pr_'
statusstring- Bundle statusone of
ADMIN_ONLYHIDDENLOCKEDSOLD_OUTON_SALEUNAVAILABLE ticket_typesarray- List of ticket type IDs included in the bundle. Ticket type id must have the prefix 'tt_'
tickettailormcp_checkout_form_element_updateUpdates an existing checkout form element.DestructiveUpdate checkout form element
Updates an existing checkout form element.
Inputs
checkout_form_element_idstringrequired- The unique identifier for the checkout form element. Must have the prefix 'cfe_'
checkout_form_idstringrequired- The unique identifier for the checkout form. Must have the prefix 'cf_'
optionsarray- The list of answers for the checkout form element
per_ticketboolean- Whether the checkout form element is asked globally or per ticket
questionstring- The question for the checkout form element
requiredboolean- Whether the checkout form element is required to answer
typestring- The type of the checkout form elementone of
multiCheckboxradioselect
tickettailormcp_discount_deleteDelete a discount.DestructiveDelete discount
Delete a discount. This action is irreversible. The discount will be permanently removed.
Inputs
discount_idstringrequired- The unique identifier for the existing discount to delete. Must have the prefix 'di_'
tickettailormcp_discount_updateUpdates an existing discount.DestructiveUpdate discount
Updates an existing discount.
Inputs
discount_idstringrequired- The unique identifier for the existing discount. Must have the prefix 'di_'
booking_feeinteger- Booking fee amount in cents
booking_fee_percentinteger- Percent of the booking fee
codestring- Discount code
expiresinteger- Discount code's expiry date as Unix timestamp
max_redemptionsinteger- The maximum number of times this discount can be used
namestring- A descriptive name given to the discount
priceinteger- Price in cents
price_percentinteger- Percent of the price
productsarray- An array of associated products with association values ('1' = add, '0' = remove, '' = do nothing)
ticket_typesarray- An array of associated ticket types with association values ('1' = add, '0' = remove, '' = do nothing)
typestring- Type of discount. Either a fixed amount or a percentageone of
fixed_amountpercentage
tickettailormcp_event_occurrence_deleteDelete event occurrence, only if there are no associated orders.DestructiveDelete event occurrence
Delete event occurrence, only if there are no associated orders. Otherwise, set it as hidden. This action is irreversible. The event occurrence will be permanently removed.
Inputs
event_occurrence_idstringrequired- The unique identifier for the existing event occurrence to delete. Must have the prefix 'ev_'
event_series_idstringrequired- The unique identifier for the existing event series. Must have the prefix 'es_'
tickettailormcp_event_occurrence_updateUpdates an existing event occurrence.DestructiveUpdate event occurrence
Updates an existing event occurrence.
Inputs
event_occurrence_idstringrequired- The unique identifier for the existing event occurrence. Must have the prefix 'ev_'
event_series_idstringrequired- The unique identifier for the existing event series. Must have the prefix 'es_'
end_datestring- Event end date in the YYYY-MM-dd format
end_timestring- Event end time in the HH:ii:ss format
hiddenboolean- True, if the event is set to hidden. False otherwise
online_linkstring- URL of the online event
override_idstring- The ID of the override that needs to be applied against the event occurrence. Must have the prefix 'ov_'
start_datestring- Event start date in the YYYY-MM-dd format
start_timestring- Event start time in the HH:ii:ss format
unavailableboolean- True, if the event is set to unavailable. False otherwise
unavailable_statusstring- Optional custom status message when the event is set to unavailable
tickettailormcp_event_series_deleteDelete an event series and its associated events.DestructiveDelete event series
Delete an event series and its associated events. This action is irreversible. The event series and its events will be permanently removed.
Inputs
event_series_idstringrequired- The unique identifier for the event series to delete. Must have the prefix 'es_'
tickettailormcp_event_series_status_changeChanges the status of an event series (publish, draft, or close sales).DestructiveChange event series status
Changes the status of an event series (publish, draft, or close sales).
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
statusstringrequired- New event series status - DRAFT: unpublished, PUBLISHED: live and available, CLOSE_SALES: published but sales closedone of
DRAFTPUBLISHEDCLOSE_SALES
tickettailormcp_event_series_updateUpdates an existing event series.DestructiveUpdate event series
Updates an existing event series.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
access_codestring- Code to access a protected event series
call_to_actionstring- Call to action text used on the event series page
countrystring- Country of the venue in ISO 3166 format
currencystring- Information about the currency the event series is configured to useone of
gbpusdeuraudbrlcadczkdkkhkdhufilsmyrmxnnoknzdphpplnsgdrubsekchfthbtryaedallamdangawgaznbambbdbdtbgnbmdbndbsdbwpbzdcdfcnydopdzdegpetbfjdgelgipgmdgydhtgidrinrjmdkeskgskhrkydkztlbplkrlrdlslmadmdlmkdmmkmntmopmvrmwkmznnadngnnprpgkpkrqarronrsdsarsbdscrslesosszltjstopttdtzsuahuzswstxcdyerzarzmw descriptionstring- Description of the event series
max_tickets_sold_per_occurrenceinteger- Maximum quantity of tickets that can be sold across all ticket types
namestring- Name of the event series
online_platformstring- Specify the name of the online platform used when the event is held online-only. This enables each event occurrence to include a link to the online event.
postal_codestring- Postal code of the venue
tickets_available_atinteger- Timestamp in UTC in seconds when tickets become available for purchase
tickets_available_at_messagestring- Message to show when tickets are not yet available to purchase. {countdown} is replaced with time remaining until tickets become available
tickets_unavailable_atinteger- Timestamp in UTC in seconds when tickets become unavailable for purchase
tickets_unavailable_at_messagestring- Message to show when tickets are unavailable to purchase
venuestring- Name of the venue
voucher_idsarray- An array of associated voucher ids with association values ('1' = add, '0' = remove, '' = do nothing)
waitlist_activestring- Indicates whether waitlist is enabled for the event seriesone of
trueno_tickets_availablefalse waitlist_call_to_actionstring- The text displayed on event action buttons and as a title above the waitlist format
waitlist_confirmation_messagestring- Text shown to the user after they have signed up to the waitlist
waitlist_event_page_textstring- Description above ticket waitlist form
tickettailormcp_hold_deleteDelete a hold.DestructiveDelete hold
Delete a hold. This action is irreversible. The hold will be permanently removed.
Inputs
hold_idstringrequired- The unique identifier for the hold to delete. Must have the prefix 'ho_'
tickettailormcp_hold_updateUpdates an existing hold.DestructiveUpdate hold
Updates an existing hold.
Inputs
hold_idstringrequired- The unique identifier for the hold. Must have the prefix 'ho_'
notestring- A string that gives more information about the created hold
ticket_type_idarray- An array of associated ticket type IDs with association values (0 = remove, any other integer = keep or add)
tickettailormcp_issued_membership_updateUpdates an existing issued membership.DestructiveUpdate issued membership
Updates an existing issued membership. Only fixed date types are allowed when updating.
Inputs
issued_membership_idstringrequired- The unique identifier for the issued membership. Must have the prefix 'im_'
emailstring- Email address of the member
first_namestring- First name of the member
last_namestring- Last name of the member
max_redemptionsstring- Maximum number of times the issued membership can be redeemed. Provide empty string to set unlimited redemptions
valid_from_dateinteger- Unix timestamp (UTC) for when the issued membership becomes valid
valid_to_dateinteger- Unix timestamp (UTC) for when the issued membership expires
tickettailormcp_issued_membership_voidVoids an existing issued membership.DestructiveVoid issued membership
Voids an existing issued membership. A voided membership cannot be used for redemptions. This action is irreversible.
Inputs
issued_membership_idstringrequired- The unique identifier for the issued membership to void. Must have the prefix 'im_'
tickettailormcp_issued_ticket_voidVoids an issued ticket.DestructiveVoid issued ticket
Voids an issued ticket. This action is irreversible. This will only mark the ticket as voided (no longer valid) and will not cancel an entire order or issue a refund. You can also void an issued ticket to a hold, which will create a hold from the issued ticket and not put the allocation back on sale.
Inputs
issued_ticket_idstringrequired- The unique identifier for the issued ticket. Must have the prefix 'it_'
void_to_holdboolean- Indicate whether to turn the existing issued ticket into a hold
tickettailormcp_membership_type_deleteDeletes a membership type.DestructiveDelete membership type
Deletes a membership type. A membership type can only be deleted if it has no issued memberships and no linked products. This action is irreversible.
Inputs
membership_type_idstringrequired- The unique identifier for the membership type to delete. Must have the prefix 'mt_'
tickettailormcp_membership_type_updateUpdates an existing membership type.DestructiveUpdate membership type
Updates an existing membership type.
Inputs
membership_type_idstringrequired- The unique identifier for the membership type. Must have the prefix 'mt_'
conditions_and_benefitsarray- Array of conditions and benefits for this membership type
max_redemptionsstring- Maximum number of times memberships of this type can be redeemed. Provide empty string to set unlimited redemptions
namestring- Name of the membership type
photo_requiredstring- Whether a photo is required when issuing memberships of this typeone of
truefalse valid_from_dateinteger- Unix timestamp (UTC) for when memberships of this type become valid. Required if valid_from_type is 'fixed'
valid_from_typestring- Type of valid from date. 'fixed' uses valid_from_date for all issued memberships, 'relative' uses the date of issueone of
fixedrelative valid_to_dateinteger- Unix timestamp (UTC) for when memberships of this type expire. Required if valid_to_type is 'fixed'
valid_to_interval_daysinteger- Number of days the membership is valid for from the issue date. Required if valid_to_type is 'relative'. Must be between 1 and 365
valid_to_typestring- Type of valid to date. 'fixed' uses valid_to_date, 'relative' uses valid_to_interval_days from issue dateone of
fixedrelative
tickettailormcp_order_confirm_paymentConfirm an offline payment has been paid for an order.DestructiveConfirm offline payment
Confirm an offline payment has been paid for an order.
Inputs
order_idstringrequired- The unique identifier for the order. Must have the prefix 'or_'
transaction_idstring- The transaction ID of the payment
tickettailormcp_order_updateUpdates an existing order.DestructiveUpdate order
Updates an existing order.
Inputs
order_idstringrequired- The unique identifier for the order. Must have the prefix 'or_'
address_1string- The first line of the address
address_2string- The second line of the address
address_3string- The third line of the address
emailstring- Buyer email address
first_namestring- Buyer first name
last_namestring- Buyer last name
phonestring- Buyer phone number
postal_codestring- Postal code, zip code or postcode
tickettailormcp_override_updateUpdate existing override.DestructiveUpdate override
Update existing override.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
override_idstringrequired- The unique identifier for the override. Must have the prefix 'ov_'
override_linesarrayrequired- An array of associated ticket types (prefix id with 'tt_'), ticket groups (prefix id with 'tg_') or bundles (prefix id with 'bu_').
max_sellable_ticketsnumber- Maximum number of sellable tickets
namestring- Override name
tickettailormcp_product_deleteDelete a product.DestructiveDelete product
Delete a product. This action is irreversible. The product will be permanently removed.
Inputs
product_idstringrequired- The unique identifier for the product to delete. Must have the prefix 'pr_'
tickettailormcp_product_updateUpdates an existing product.DestructiveUpdate product
Updates an existing product.
Inputs
product_idstringrequired- The unique identifier for the product. Must have the prefix 'pr_'
booking_feeinteger- Optional booking fee in cents which is charged per product to the customer and the funds are paid to you. We would recommend charging no more than 10% of the product price.
currencystring- Currency that the product can be purchased in. Defaults to the box office currency.one of
gbpusdeuraudbrlcadczkdkkhkdhufilsmyrmxnnoknzdphpplnsgdrubsekchfthbtryaedallamdangawgaznbambbdbdtbgnbmdbndbsdbwpbzdcdfcnydopdzdegpetbfjdgelgipgmdgydhtgidrinrjmdkeskgskhrkydkztlbplkrlrdlslmadmdlmkdmmkmntmopmvrmwkmznnadngnnprpgkpkrqarronrsdsarsbdscrslesosszltjstopttdtzsuahuzswstxcdyerzarzmw descriptionstring- Description of the product
event_series_idsarray- List of event series IDs that have the product with association values ('1' = add, '0' = remove, '' = do nothing)
instructionsstring- Instructions on how to purchase the product
issue_ticket_voucherstring- Indicate whether the QR code is to be issued for the product. Mutually exclusive with voucher_id and membership_type_id.one of
truefalse linked_to_all_event_seriesstring- Indicate whether the product is linked to all event seriesone of
truefalse membership_type_idstring- The ID of a membership type to associate with the product. Must start with 'mt_' prefix. Mutually exclusive with issue_ticket_voucher and voucher_id.
modify_quantitystring- Number of products to add or remove. The number should be preceded by a + or - sign
namestring- Name of the product
priceinteger- Cost of the product in cents
quantityinteger- Number of products available for purchase
quantity_per_eventinteger- Number of products available for purchase per event
quantity_unlimitedstring- If set to 'true', the quantity will be set to unlimited. Otherwise, it will be set to the quantity givenone of
truefalse statusstring- Product statusone of
on_salehiddensold_out voucher_idstring- The ID of a voucher of type gift card to associate with the product. Must start with 'vo_' prefix. Mutually exclusive with issue_ticket_voucher and membership_type_id.
tickettailormcp_store_updateUpdates the store configuration including currency, name, and associated products.DestructiveUpdate store information
Updates the store configuration including currency, name, and associated products. This allows you to modify your Ticket Tailor store settings such as changing the currency, updating the store name, or managing which products are available in the store. The currency can be set to various supported currencies, and products can be added or removed by providing an array of product IDs. Empty products array will remove all products from the store.
Inputs
storeIdstringrequired- The ID (prefixed with 'st_') of the store to update
currencystring- The currency code used by the storeone of
gbpusdeursgdaudbrlcadczkdkkhkdhufilsjpymyrmxnnoknzdphpplnrubsekchftwdthbtry namestring- Name of the store
productsarray- Array of product IDs that are sold in the store. Empty array will remove all products from the store. Product IDs should be prefixed with 'pr_'
tickettailormcp_ticket_group_deleteDelete a ticket group.DestructiveDelete ticket group
Delete a ticket group. This action is irreversible. The ticket group will be permanently removed and any associated ticket types and bundles will be removed from the group.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
ticket_group_idstringrequired- The unique identifier for the ticket group to delete. Must have the prefix 'tg_'
tickettailormcp_ticket_group_updateUpdates an existing ticket group.DestructiveUpdate ticket group
Updates an existing ticket group.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
ticket_group_idstringrequired- The unique identifier for the ticket group. Must have the prefix 'tg_'
bundle_idsarray- Array of bundle IDs that belong to this group. Bundle id must have the prefix 'bu_'
max_per_orderinteger- Maximum number of tickets of this group that can be purchased in a single order. Prevents bulk purchases and ensures fair distribution
max_quantityinteger- Maximum number of ticket types that this group can sell
min_per_orderinteger- Minimum number of tickets of this group that must be purchased in a single order. Useful for group discounts or package deals
namestring- Name of the ticket group
ticket_type_idsarray- Array of ticket type IDs that belong to this group. Ticket type id must have the prefix 'tt_'
tickettailormcp_ticket_type_deleteDelete a ticket type.DestructiveDelete ticket type
Delete a ticket type. This action is irreversible. The ticket type will be permanently removed.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
ticket_type_idstringrequired- The unique identifier for the ticket type to delete. Must have the prefix 'tt_'
tickettailormcp_ticket_type_updateUpdates an existing ticket type.DestructiveUpdate ticket type
Updates an existing ticket type.
Inputs
event_series_idstringrequired- The unique identifier for the event series. Must have the prefix 'es_'
ticket_type_idstringrequired- The unique identifier for the ticket type. Must have the prefix 'tt_'
access_codestring- Code to access a hidden ticket
booking_feeinteger- Optional booking fee which is charged per ticket type to the customer and the funds are paid to you. We would recommend charging no more than 10% of the ticket price.
descriptionstring- Description of the ticket type
discountsarray- An array of associated discount ids with association values ('1' = add, '0' = remove, '' = do nothing)
group_idstring- ID of the group this ticket type belongs to. Group id must have the prefix 'tg_'
hide_afterinteger- Timestamp in seconds when the ticket type should be hidden until.
hide_untilinteger- Timestamp in seconds when the ticket type should be hidden after.
hide_when_sold_outboolean- Hide the ticket when it has sold out
max_per_orderinteger- Maximum number of tickets allowed per order
min_per_orderinteger- Minimum number of tickets allowed per order
modify_quantitystring- Number of ticket types to add or remove. The number should be preceded by a + or - sign
namestring- Name of the ticket type
priceinteger- Cost of the ticket type
show_quantity_remainingstring- Specifies whether to show the number of tickets still availableone of
truefalse show_quantity_remaining_less_thaninteger- Only show number of tickets still available when the available quantity is equal to or lower than this threshold
statusstring- Event series statusone of
ON_SALESOLD_OUTUNAVAILABLEHIDDENADMIN_ONLYLOCKED zero_ticketsstring- Set the number of available tickets to zeroone of
truefalse
tickettailormcp_voucher_code_voidVoids a voucher code.DestructiveVoid voucher code
Voids a voucher code. This action is irreversible. This will only mark one voucher code as voided, and will not impact the other related codes.
Inputs
voucher_code_idstringrequired- The unique identifier for the voucher code. Must have the prefix 'vc_'
voucher_idstringrequired- The unique identifier for the voucher. Must have the prefix 'vo_'
tickettailormcp_voucher_deleteDelete voucher and its associated voucher codes.DestructiveDelete voucher
Delete voucher and its associated voucher codes. This action is irreversible. The voucher and its voucher codes will be permanently removed.
Inputs
voucher_idstringrequired- The unique identifier for the existing voucher to delete. Must have the prefix 'vo_'
tickettailormcp_voucher_updateUpdates an exist ing voucher's name and properties.DestructiveUpdate voucher
Updates an exist ing voucher's name and properties.
Inputs
voucher_idstringrequired- The unique identifier for the existing voucher. Must have the prefix 'vo_'
codesarray- An array of associated voucher codes
event_series_idsarray- An array of associated event series IDs with association values ('1' = add, '0' = remove, '' = do nothing)
expiryinteger- Voucher's expiry date as Unix timestamp
intervalstring- Only available when voucher_type is gift_card. Voucher's expiry date is calculated from this number of days on day of issueone of
3090365 namestring- A descriptive name given to the voucher
valueinteger- Voucher value in cents
tickettailormcp_waitlist_signup_deleteDelete event series waitlist signup.DestructiveDelete waitlist signup
Delete event series waitlist signup. This action is irreversible.
Inputs
event_series_idstringrequired- The unique identifier for the event series that the waitlist signup is part of. Must have the prefix 'es_'
waitlist_signup_idstringrequired- The unique identifier for the waitlist signup to delete. Must have the prefix 'ws_'
No tools match.
