# Humanitix MCP > Humanitix connects your AI agents to the Humanitix ticketing platform, giving you access to core event logistics data. This MCP lets you manage everything from listing upcoming events and checking ticket inventory levels to compiling detailed attendee lists for any single function or gala. It’s designed for automating event operations and social impact initiatives. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** ticketing, event-registration, attendee-management, social-impact, ticket-sales, community-engagement ## Description Need to keep tabs on a large community event? Humanitix gives your AI agents the tools to handle complex ticketing logistics without needing manual input. You can pull details about specific events, list all possible campaigns running through the platform, or get a full roster of attendees for any function. It handles everything from ticket sales tracking and inventory checks to viewing general organization data, making event management feel like a single API call away. If your job involves coordinating community gatherings—whether they're physical galas or virtual conferences—this integration is key. By connecting Humanitix via Vinkius, your AI client gains immediate access to this entire suite of operational tools, letting you automate the tedious backend work and focus on the actual event experience. ## Tools ### get_event Retrieves all necessary details for one specific event by its ID. ### get_me Confirms and returns the authenticated user's profile information. ### list_attendees Gathers a list of all registered people for an event ID you provide. ### list_campaigns Displays every marketing campaign currently set up in the system. ### list_events Provides a list of all virtual and physical events available on the platform. ### list_hosts Lists every individual or organization designated as an event host. ### list_inventory Displays general operational inventory items related to the events. ### list_orders Retrieves a list of all ticket purchase orders placed by users. ### list_tickets Lists every unique ticket record across the entire system, regardless of event. ### list_venues Provides a directory and list of all registered event locations. ## Prompt Examples **Prompt:** ``` List all upcoming charity events in my Humanitix account. ``` **Response:** ``` I'll fetch the list of upcoming events for you. ``` **Prompt:** ``` Show me the attendee list for the Annual Gala. ``` **Response:** ``` I'll retrieve the registered attendees for that event. ``` **Prompt:** ``` Check how many tickets are left for event ID 789. ``` **Response:** ``` I'll check the inventory and ticket availability for you. ``` ## Capabilities ### Get Specific Event Details Retrieve core information about a single event, including dates, locations, and general setup details. ### Manage Attendee Rosters Generate comprehensive lists of people who registered for an event or function. ### Track Ticket Orders and Inventory Check ticket sales status, view historical order records, and confirm how many tickets are left for sale. ### List Campaigns and Hosts View all active marketing campaigns and the specific people or groups running events on the platform. ### Find Event Venues and Inventory Access a catalog of potential event locations, venues, and general event inventory items. ## Use Cases ### The Annual Gala Attendance Audit A director needs to know who is actually attending the annual gala. They tell their agent: 'Give me all registered people for Event ID 456.' The agent uses `list_attendees` and returns a clean roster, eliminating hours of database cross-referencing. ### Checking Ticket Availability Post-Launch The operations team needs to know if they can sell more tickets for next month's workshop. They run `list_inventory` and immediately see the remaining count, avoiding a panic when capacity is unexpectedly low. ### Comparing Venues Against Events A planner needs to see if any of their listed events are held at an unlisted location. They pull all available venues via `list_venues` and cross-reference them against the event details from `get_event`. ### Tracking a Specific Campaign's Success A marketing lead wants to understand the scope of their recent promotions. They run `list_campaigns` to see every active effort and can then check ticket orders using `list_orders` to tie sales back to that campaign. ## Benefits - Stop manually checking ticket counts. Use `list_inventory` or `list_tickets` to instantly see how many passes are left for any event. - Build a complete attendee profile without switching tabs. Run `list_attendees` against an event ID, and you get the full roster right back in your workflow. - Streamline reporting by listing all events using `list_events`. This gives you a master list to feed into reports or other systems. - Verify user permissions and data access by calling `get_me` first. It confirms who's making the calls before they attempt complex actions. - Keep track of your marketing efforts efficiently. You can pull every active promotion using `list_campaigns`, ensuring no initiative falls through the cracks. ## How It Works The bottom line is: you use general listing calls to find what you need, and specific retrieval calls to get the detailed numbers. 1. Your AI client first calls `list_events` to get an overview of all upcoming or past gatherings you need information about. 2. You then narrow the scope by calling a specific tool, like `get_event`, using the ID found in the initial list, which pulls the deep-dive data packet for that single event. 3. Finally, your agent uses the event details to call related tools, such as `list_attendees` or `list_tickets`, to pull the granular data points needed. ## Frequently Asked Questions **How do I check ticket availability using `list_tickets`?** You use `list_tickets` to see all available tickets across the whole system. If you need the count for a specific event, it’s better to call `list_inventory` first. **What does `get_event` do?** `get_event` retrieves comprehensive details about one single event using its unique ID. It gives you the core metadata needed before checking attendees or tickets. **Do I need to call `list_hosts` before listing events?** No, you don't. While `list_hosts` shows who runs events, calling `list_events` gives you the full schedule regardless of who is organizing it. **How can I get a list of venues using `list_venues`?** Running `list_venues` provides a complete directory of all known physical locations. You then use this data to help decide if an event needs to be listed in the system. **If I need to confirm my permissions or user details, how do I use the `get_me` tool?** It immediately returns your current authenticated user profile. This is essential for verifying access rights and making sure your agent has the necessary scope before running complex operations like listing orders. **I need to trace a ticket back to its purchase record; how does `list_orders` help?** The tool retrieves detailed records for all ticket purchases. This allows you to link specific tickets or inventory items directly to a completed transaction, providing crucial financial context. **When I only want the attendees for one event, what is the proper way to use `list_attendees`?** You must provide the unique Event ID in the request. The tool filters the entire database and returns a clean list of registered people specifically tied to that single event. **How can I check what marketing campaigns are active or available by using `list_campaigns`?** It lists all existing campaign metadata within your account. This helps you track promotional periods, understand current pricing structures, and scope out future marketing efforts. **How do I get Humanitix API credentials?** You can find your API key in your Humanitix dashboard under Account Settings > API. Ensure you have the necessary permissions to access event data. **Can I see attendee emails?** Yes, the list_attendees tool provides access to registered attendee details including contact information if available. **Is inventory management supported?** Yes, the list_inventory tool allows you to track ticket availability and stock levels.