# Hipsy MCP for AI Agents AI Agent Connect > Hipsy MCP. Sell event tickets, manage registrations, and promote parties and festivals with a ticketing platform made for nightlife and entertainment. It connects your event data to your AI client so you can handle orders, check-ins, and revenue reports through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_DnrSw5cA7JtNcXPsJK1dF9WkFoWPDQMTpv9n1P2R/ai-agent-connect - **Tags:** ticketing, event-registration, attendee-check-in, revenue-reporting, event-analytics, sales-tracking ## Description You're running a nightlife venue or a festival, and you're tired of jumping between tabs to see how many people actually showed up or how much money you've cleared today. This Connector lets you bring all your ticketing data into one place where your AI client can actually do something with it. Instead of digging through a dashboard to find a specific order or checking a spreadsheet to see which ticket types are selling out, you just ask your agent. You can pull up real-time scan statistics to see if your door team is keeping up, or get a full breakdown of your revenue by payment method for the last few shows. It handles the heavy lifting of data retrieval so you can focus on the actual event. Having this in your Vinkius catalog means you can connect your ticketing operations to your existing workflow without moving data around manually. It's about getting answers to questions like how many people are in the building or what's our net profit this month without ever leaving your chat window. You can also check on your organization's profiles, browse past events to see how they performed, and keep tabs on your upcoming schedule all in one conversation. Whether you're auditing a payment from a customer or checking if a specific VIP ticket is still available, the information is always just a prompt away. This removes the friction of manual data entry and gives you a clear picture of your business in real-time. ## Tools ### get_order Use get_order to see the specific details for one ticket purchase. This is what you need to help a customer with a booking issue. ### get_organisation Use get_organisation to see the full profile for a specific organization. This helps you manage your account settings. ### get_scan_stats Use get_scan_stats to see your scan statistics. This tells you the total number of people who checked in and the current scan rate. ### list_attendees Use list_attendees to see everyone on your guest list. This helps you manage who is allowed into your event. ### list_events Use list_events to see your full event calendar. This gives you a bird's eye view of every show you have planned. ### list_orders_by_event Use list_orders_by_event to see every ticket sale for a specific show. This is great for auditing sales for a single night. ### list_orders Use list_orders to see every ticket sale in your entire account. This helps you track general transactions across all events. ### list_organisations Use list_organisations to see all the different entities in your account. This is useful for managing multiple venues or brands. ### list_past_events Use list_past_events to see shows that have already finished. This is your primary way to pull historical data for reports. ### list_scans Use list_scans to see individual check-in entries. This lets you see exactly when someone entered the venue. ### check_hipsy_status Use check_hipsy_status to see if your connection to the platform is active. This is the first thing to check if you have trouble. ### get_event_revenue Use get_event_revenue to see the total money made from a specific event. This provides a breakdown of payment types and sales. ### get_event Use get_event to see the full details of a single event. This includes information on the venue, date, and ticket types. ### list_ticket_types Use list_ticket_types to see the different pricing and availability options for an event. This helps you see what's still for sale. ### list_upcoming_events Use list_upcoming_events to see only the shows that haven't happened yet. This is perfect for planning your next move. ### list_webhooks Use list_webhooks to see all your active webhook endpoints. This lets you check if your external integrations are working. ## Prompt Examples **Prompt:** ``` How many people checked in for the Jazz Night last night and what was the scan rate? ``` **Response:** ``` Check-in stats for 'Jazz Night' (event_298, Apr 19): * **Total tickets sold:** 185 * **Checked in:** 162 (87.6% scan rate) * **Unique scans:** 162 * **Not checked in:** 23 attendees **No-show highlights:** - 5 VIP tickets (€85 each = €425 unredeemed) - 18 Regular tickets **Peak check-in window:** 7:00-7:30 PM (68 scans) **Last scan:** 9:15 PM ``` **Prompt:** ``` Give me a revenue breakdown for all our events from this month. ``` **Response:** ``` Here is the revenue summary for this month's events: | Event Name | Total Revenue | Tickets Sold | Payment Split | | :--- | :--- | :--- | :--- | | Jazz Night | €12,450 | 185 | 82% Card, 18% iDEAL | | Art Exhibition | €8,330 | 92 | 75% Card, 25% iDEAL | | Comedy Show | €12,000 | 240 | 90% Card, 10% iDEAL | **Total Revenue:** €32,780 ``` **Prompt:** ``` Show me the remaining ticket types and prices for the upcoming Summer Music Festival. ``` **Response:** ``` For the upcoming 'Summer Music Festival', here are the current ticket types: * **Early Bird:** €25 (SOLD OUT) * **Regular:** €40 (142/300 sold) * **VIP:** €85 (28/50 sold) Would you like me to list all upcoming events or check the scan stats for the last show? ``` ## Capabilities ### Pull real-time scan stats Get a live look at how many people have checked in and the current scan rate. ### Manage guest lists List all attendees for a specific event to see who is registered. ### Track ticket sales Browse all orders and filter them by specific events or buyer info. ### Audit event revenue Retrieve total revenue and payment breakdowns for any given show. ### Check ticket availability View ticket types, pricing, and current stock levels for your events. ### Monitor door flow Review individual scan entries to see exactly when people are entering. ## Use Cases ### Monitoring live door flow A venue manager needs to know if the line is moving fast enough. They ask the agent for scan stats using get_scan_stats to see the current scan rate. ### Post-event revenue auditing A promoter wants to know the total profit from last night. They use get_event_revenue to get the total amount and breakdown of card vs. iDEAL payments. ### Resolving a customer booking issue A finance team needs to audit a specific buyer. They use get_order to pull up the specific payment status and buyer info for a single transaction. ### Planning future ticket inventory An organizer wants to see what's left for next month. They use list_upcoming_events and list_ticket_types to check remaining capacity for all future shows. ## Benefits - Get real-time door flow metrics with get_scan_stats to see if your entry team is moving fast enough during a show. - Pull full revenue reports with get_event_revenue to see exactly how much money came in from different payment types. - Track every sale across your organization using list_orders to keep your records accurate without manual exports. - Monitor attendee check-ins with list_attendees to manage capacity and guest lists on the fly. - View ticket availability with list_ticket_types to see which categories are selling out the fastest. - Audit every transaction with get_order to quickly resolve customer issues or payment discrepancies. ## How It Works The bottom line is you get a conversational interface for your entire ticketing operation. 1. Subscribe to the Hipsy MCP on the Vinkius marketplace. 2. Enter your Hipsy API Key from your account settings. 3. Ask your AI client to check your latest ticket sales or scan rates. ## Frequently Asked Questions **Can the Hipsy MCP help me monitor door flow in real-time?** Yes, it pulls live scan statistics so you can see how many people are checking in and the current scan rate instantly. **Can I use this to see how much money I made from different payment types?** Yes, the Connector can pull a full revenue breakdown for any event, showing you the split between different payment methods like cards and iDEAL. **How do I use Hipsy MCP to manage my guest list?** You can simply ask your agent to list all attendees for a specific event, and it will pull the full registered guest list for you. **Can this Connector help my finance team audit past sales?** Absolutely. It can retrieve every ticket order from your past events, including buyer info and payment status, for easy auditing. **Does the Hipsy MCP work for festivals too?** Yes, it is designed for both nightlife venues and large-scale entertainment events like festivals and concerts. **Can I check if my API connection is active?** Yes, there is a specific command to verify that your connection to the Hipsy platform is active and working correctly. **Can I track ticket sales and revenue for a specific event?** Yes. Use `get_event_revenue` with an Event ID to retrieve total revenue, ticket sales breakdown by type, and payment method distribution. Use `list_orders_by_event` to see individual orders with buyer details and amounts. Use `list_ticket_types` to see pricing and availability per ticket tier. **Can I monitor attendee check-ins in real time?** Yes. Use `list_attendees` to see all attendees with their check-in status. Use `list_scans` for individual scan entries with timestamps. Use `get_scan_stats` for aggregate metrics: total tickets scanned, unique scans, and overall scan rate percentage. **Can I view only upcoming or past events separately?** Yes. Use `list_upcoming_events` for future events sorted by date, or `list_past_events` for completed events useful for post-event reporting. Use `list_events` for all events regardless of date, and `get_event` for complete details of any specific event.