# Universe MCP > Universe manages your entire event lifecycle—from initial listings and ticket sales to on-site check-in. Use Universe via your AI agent to list all events, retrieve detailed guest lists and order histories, generate QR tokens, or instantly mark tickets as checked in. It keeps the operational data right where it belongs: in your event platform. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** ticketing, guestlist, check-in, event-planning, universe-api ## Description Look, you're tired of jumping between ten different tabs just to run an event. You don't wanna live in a dashboard graveyard. Connect your Universe account via your AI agent, and it handles all the heavy lifting for you through natural conversation. It keeps your operational data right where it belongs: inside your event platform. **Getting Your Event View:** The agent pulls a complete list of scheduled events linked to your host account ID using `get_events`. Need to know about general stuff? You can run `list_listings` to pull every single listing managed under that host account. It gives you a full read on what's happening across the board. **Managing Attendees and Data:** You need to see who showed up, or who *should* show up. The agent uses `list_guestlists` to grab detailed attendee data and any custom form answers. You can filter this down by an entire event ID or even just a specific listing ID. When you're ready to crunch the numbers, run `get_event_orders`. This tool retrieves every order record and all associated attendee details, letting you analyze sales performance and know what types of people are buying tickets. **Handling Check-In and Access:** The front desk needs speed. You provide a ticket ID to the agent, and it instantly marks that ticket as checked into the specific event using `check_in`. For VIPs or special access groups, you can manage private entry with `create_access_key`, ensuring only authorized people get in. **Generating Tokens:** Forget printing stacks of paper. The agent uses `get_event_tokens` to fetch all the necessary QR code tokens for any group of attendees you specify. It's quick, it's digital, and it works every time. It’s simple: list everything with `list_guestlists`, get the tickets ready with `get_event_tokens`, run through check-in using `check_in`, or see what sold like hotcakes by hitting up those order records with `get_event_orders`. ## Tools ### create_access_key Manages and creates private access keys for exclusive or VIP tickets. ### check_in Marks a specific ticket ID as checked in for an event. ### get_events Pulls a list of scheduled events linked to your host account ID. ### list_guestlists Retrieves comprehensive attendee information, filterable by either an event or a listing ID. ### list_listings Gets a full list of all general event listings managed by the host account. ### get_event_orders Retrieves all order records and associated attendee data for a specific event ID. ### get_event_tokens Generates the QR code tokens needed for attendees at an event. ## Prompt Examples **Prompt:** ``` List all active events for host ID 98765. ``` **Response:** ``` I've retrieved the events for host 98765 using `get_events`. You have 'Tech Summit 2024' (ID: 112233) and 'AI Workshop' (ID: 445566) currently active. Which one would you like to manage? ``` **Prompt:** ``` Show me the guestlist for event 112233. ``` **Response:** ``` Fetching the guestlist for event 112233 via `list_guestlists`... I found 150 attendees. Recent registrations include Alice Smith and Bob Jones. Would you like to see the custom form answers for these guests? ``` **Prompt:** ``` Check in ticket ID 556677. ``` **Response:** ``` Processing check-in for ticket 556677 using `check_in`... Success! The attendee has been marked as checked-in for the event in Universe. ``` ## Capabilities ### List all events The agent pulls a complete list of scheduled events or general listings associated with your host account. ### Get specific guest lists It retrieves attendee data and custom form answers, filtered by either an event ID or a listing ID. ### Check in attendees You provide a ticket ID, and the agent marks that ticket as checked into the specific event within Universe. ### Generate tokens The agent fetches the QR code tokens for any group of attendees you specify. ### Analyze sales data It queries historical order and rate information to give you a summary of event performance and attendee types. ## Use Cases ### The last-minute guest list check A planner needs to confirm if a VIP attendee, Jane Doe, is on the roster for 'Tech Summit 2024' (ID: 112233). Instead of checking the dashboard and clicking through multiple tabs, they just ask their agent. The agent runs `list_guestlists`, confirms Jane’s presence, and provides her custom form answers immediately. ### Automated front-of-house operations It's peak check-in time for 'Music Fest.' Staff don't have time to search. They tell their agent the ticket ID (`556677`). The agent uses `check_in`, processes the request, and confirms success—all in seconds. ### Analyzing low-performing listings Marketing wants to know if a smaller listing is worth promoting. They ask their agent to run `get_event_orders` across several similar events. The resulting data helps them see which rate types are generating the most revenue, allowing them to adjust future pricing. ### Handling private access The venue needs to grant special access to a small group of donors who aren't public attendees. Instead of emailing manual keys, they ask the agent to `create_access_key`, generating and managing the secure key directly through the system. ## Benefits - Instant Check-In: Use the `check_in` tool with a ticket ID. You mark attendance instantly without needing front-desk staff to manually look up records or press multiple buttons. - Full Attendee View: The `list_guestlists` tool lets you pull every piece of attendee data—name, custom answers, order details—whether they signed up for an event or just a listing. - Ticket Generation: Need tokens? The `get_event_tokens` tool generates QR codes on demand. You don't have to manually upload batch files; you ask the agent to get them. - Visibility into Listings: Use `list_listings` and `get_events`. This lets your AI client show you all available event options for a host, giving you an immediate overview of the entire schedule. - Data Accountability: Running `get_event_orders` allows you to instantly see sales performance details. You know exactly who bought what and how much money was spent at that specific event. ## How It Works The bottom line is, you manage all event operations by talking to your agent instead of navigating the dashboard manually. 1. Subscribe to the Universe server. Then, enter your personal access token. 2. Your AI client sends a natural language request (e.g., 'Check in ticket 556677'). 3. The agent uses the appropriate tool (`check_in`) and executes the operation against your live Universe data. ## Frequently Asked Questions **How do I find out what events are available for my host account using `get_events`?** The agent pulls a list of all scheduled events linked to your ID. If you also want general venue listings that aren't tied to a date, use the `list_listings` tool instead. **What is the difference between using `get_event_tokens` and manually generating tickets?** The agent uses `get_event_tokens` to pull the most current QR code tokens directly from Universe. This ensures your attendees have valid, real-time access credentials. **Can I check in a ticket if I only know the name?** The agent requires a specific ticket ID for the `check_in` tool to work. You must retrieve the correct ticket ID first, usually by running `list_guestlists`, before attempting to check them in. **How do I analyze sales data using `get_event_orders`?** You provide the event ID, and the agent retrieves all order records. This lets you see rates, quantities, and totals for that specific event's performance. **When should I pass my API token when calling `list_guestlists`?** You must include your Universe Personal Access Token in the request headers. This confirms your agent's permission level to view private attendee records and prevents unauthorized data access. **What happens if I run `check_in` with a ticket ID that doesn't exist?** The tool immediately throws an error code stating the ticket ID is invalid. You must confirm the specific ID against your source data before attempting check-in to avoid failure. **How does `create_access_key` help manage private event security?** This tool generates unique, secure keys for VIP or exclusive tickets. It ensures that entry is restricted only to those with the specific key, bypassing standard attendee lookups. **How can I use `list_listings` to see different event types?** The tool retrieves all defined listing categories and metadata for your account. You filter by date range or listing type within the prompt to quickly narrow down the results you need. **Can I use the AI to check in guests at the door?** Yes! Use the `check_in` tool with the ticket ID. It marks the attendee as checked-in in the Universe system immediately. **How do I get a list of everyone attending my event?** You can use the `list_guestlists` tool to fetch attendee info. You can filter by `event_id` or `listing_id` and even set a limit for the results. **Is it possible to create access keys for hidden tickets via chat?** Yes, the `create_access_key` tool allows you to manage access keys for private tickets by providing the necessary JSON payload.