# Ticket Tailor MCP > Ticket Tailor connects your AI agent directly to event ticketing data. It lets you list all events, check ticket tiers and pricing for any date, track specific sales orders, or verify individual attendee tickets—all through natural conversation. Stop opening multiple browser tabs just to find out how many 'Early Bird' passes are left. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** event-ticketing, event-management, ticket-sales, attendee-management, box-office, tickettailor ## Description **Ticket Tailor connects your AI agent straight to your ticketing data.** Forget opening a dozen browser tabs just trying to figure out how many 'Early Bird' passes you got left—your agent handles it all through natural talk. You manage every registration, ticket sale, and attendee detail without ever having to log into the web dashboard. It’s built for people who actually run shows, not for the guys playing with fancy dashboards. When your AI client hits this MCP Server, you get five critical tools right away. Here's what they do: * **`list_events`**: This tool hands you a master list of every single event—whether it ran last year or pops off next month—that’s managed in your account. * **`get_event_details`**: When you pick an event from that list, this one digs deep. It pulls all the metadata and setup details for just that specific event ID. You can check configuration settings, see how it's categorized, or pull any other foundational data the system uses to run the show. * **`list_ticket_types`**: Wanna know what people are paying? This tool lists every single ticket tier and its price point for an event you specify. You can check all the options—VIP passes, general admission, student rates—and see exactly how much each one costs at a glance. * **`list_event_orders`**: Need to track the money? Use this tool to query your sales orders. You'll get a list of transactions you made and can filter that rundown by a specific Event ID or even narrow it down with date ranges. This lets you review revenue trends instantly. * **`list_issued_tickets`**: When you need proof someone bought a ticket, this tool pulls up the details for individual tickets assigned to attendees. You can check participant names, see their current order status, or verify if they’re marked as available for check-in. It's your ultimate attendee verification system. You don't have to juggle multiple systems just because you need a basic answer. If you gotta know what's running, you use `list_events`. If you wanna see the specific setup details on one show, you run `get_event_details` using its ID. To check pricing tiers for any event—like seeing if student rates are still available—you call `list_ticket_types`. When it comes to sales history and checking revenue streams, you ask `list_event_orders`, filtering by the specific show ID or a date window. If someone shows up at the door and you gotta confirm they paid and got a ticket, you use `list_issued_tickets` to pull up their full details and status. This isn't just about data; it’s about doing work faster. You can check out all your events and then immediately jump into pricing for one of 'em, track the sales from that show, and finally confirm an attendee name—all without leaving your chat window. It keeps you focused on running the event, not fighting with browser tabs. ## Tools ### get_event_details Fetches detailed metadata and configuration settings for a single, specific event ID. ### list_events Provides a complete list of all events currently managed in the Ticket Tailor system. ### list_issued_tickets Retrieves details for individual tickets that have been issued to attendees. ### list_event_orders Lists sales orders from your account; you can filter this list by specifying an Event ID. ### list_ticket_types Lists all different ticket tiers and price points available for a specific event. ## Prompt Examples **Prompt:** ``` List all active events in my Ticket Tailor account. ``` **Response:** ``` I've retrieved your events. You have 3 upcoming events: 'Tech Conference 2024', 'Summer Music Festival', and 'AI Workshop Series'. Which one would you like to see sales data for? ``` **Prompt:** ``` Show me the ticket tiers for 'Tech Conference 2024' (ID: ev_10293). ``` **Response:** ``` I've fetched the ticket types for ev_10293. You have: 'Early Bird' ($150), 'Standard Entry' ($250), and 'VIP All-Access' ($500). 'Early Bird' is currently sold out. ``` **Prompt:** ``` How many tickets were issued for the 'Summer Music Festival'? ``` **Response:** ``` Retrieving data... For the 'Summer Music Festival' (ID: ev_88231), a total of 450 tickets have been issued so far. Shall I list the most recent orders? ``` ## Capabilities ### View Event Catalogs List all events managed by your account using `list_events`, giving you a master list of what's running. ### Check Pricing Tiers Determine available ticket types and their associated costs for any specific event via `list_ticket_types`. ### Track Sales History Query sales orders using `list_event_orders`, filtering records by a specific event ID to review revenue trends. ### Retrieve Event Details Get deep metadata and configuration settings for one single event using `get_event_details`. ### Verify Attendees List specific issued tickets using `list_issued_tickets` to confirm participant names, order status, or check-in availability. ## Use Cases ### Support Agent verifying a ticket A customer calls claiming they paid but have no confirmation. The agent asks their AI client, 'Show me tickets for John Doe.' The agent runs `list_issued_tickets`, confirms the order ID and status, and tells the customer exactly what's up. Problem solved in seconds. ### Marketing team checking promotions The marketing manager needs to know if they can run a 'Student Rate.' They ask their agent to check ticket tiers for the next festival. The server runs `list_ticket_types` and confirms that, yes, 'Student' is an existing tier at $50. ### Organizer reviewing end-of-quarter sales It’s the first day of the month. The organizer asks their agent to list all orders for the 'Tech Conference 2024' from the last quarter. Running `list_event_orders` quickly summarizes total revenue and volume, giving them a clear snapshot. ### IT checking event setup data An engineer needs to know the official capacity limits or internal IDs for an old conference. They use `get_event_details` on the specific ID; it pulls all the required metadata without needing access to the main web dashboard. ## Benefits - Stop guessing pricing. Use `list_ticket_types` to instantly see every available ticket tier and its current cost for an event, preventing sales errors. - Track revenue flow without manual exports. Call `list_event_orders` with a date filter to monitor how many tickets sold last month vs. this quarter. - Handle support queries faster. Need to verify if someone bought a ticket? Use `list_issued_tickets` and provide the name; it returns the exact order status immediately. - Get a full picture of your calendar. Instead of digging through old reports, use `list_events` to pull a master list of every event you run, past and future. - Deep dive into any single event's setup. If you need specific configuration details (like capacity limits or unique IDs), `get_event_details` provides the full metadata dump. ## How It Works The bottom line is that you use plain language commands in chat; the server runs the necessary API calls behind the scenes to get the data. 1. Subscribe to the Ticket Tailor server and enter your API key (found in your account settings). 2. Your AI client authenticates with Vinkius, granting it read-only access to your event data. 3. You ask your agent a question like, 'Show me ticket types for the Tech Conference.' The agent then calls `list_ticket_types` and reads the results back. ## Frequently Asked Questions **How do I find out what events are available using the Ticket Tailor MCP Server?** Run `list_events`. This tool gives you a complete list of all active and past events managed by your account, letting you know exactly which IDs to reference later. **Can I check ticket prices for an event using the Ticket Tailor MCP Server?** Yes, use `list_ticket_types`. You just need to provide the event ID, and it lists every available tier (like VIP or Early Bird) along with its specific price point. **What is the best way to check a customer's ticket status with list_issued_tickets?** You pass the unique attendee identifier or order ID. The tool returns confirmation data and shows if the ticket has been checked in, giving your agent instant verification. **Does list_event_orders let me see sales for multiple events?** No, `list_event_orders` works best when you narrow down the scope. It accepts an optional event ID filter, so keep it focused on one specific event's sales records. **If I need to check detailed metadata or configuration for one specific event, how do I use the get_event_details tool?** Use `get_event_details` by passing the unique Event ID. This returns deep configuration settings—not just a name and date. You'll find details like branding rules and ticketing policies that aren't available in simple listing calls. **When I use list_event_orders, how do I query for sales data specific to one single order ID?** You must pass the Order ID directly into the `list_event_orders` function. This isolates the record you need, allowing you to track payment methods or specific item purchases without fetching every other sale. **Does list_ticket_types tell me if a ticket tier is currently sold out?** Yes, `list_ticket_types` returns status flags for each listed tier. It shows you the current inventory count and whether that specific price point or type is marked as sold out. **What should I do if my AI client encounters a rate limit while running multiple tools?** If your agent hits a rate limit, wait about 60 seconds before re-running the sequence. The MCP server handles throttling automatically; you just need to slow down the calls between different functions. **Can I see how many tickets have been sold for a specific event?** Yes! Use the `list_event_orders` tool and provide the Event ID. Your agent will retrieve all sales orders, allowing you to calculate total volume and revenue. **How do I list the different prices and ticket tiers for an event?** Run the `list_ticket_types` query with your Event ID. The agent will return all configured ticket tiers, including names, prices, and availability. **Is it possible to verify an individual attendee's ticket via AI?** Absolutely. Use the `list_issued_tickets` tool. You can ask the AI to find a specific attendee by name or ID to verify their ticket status and check-in data.