# Eventcube MCP MCP

> Eventcube MCP handles all aspects of event operations, including ticketing, venue setup, and order management. It lets your AI client track real-time ticket sales, list active events, and manage attendee lists—all through natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** eventcube, ticketing, events, attendees

## Description

Managing a large series of events means juggling data across five different dashboards: one for venues, one for event details, one for tickets sold, one for orders placed, and one for categories. This MCP pulls all that into your agent. You don't have to copy sales numbers from one spreadsheet and paste them into another system just because the attendee list is out of sync. Instead, you talk to your AI client, and it handles the data flow. It can check how many tickets are left for a specific event or quickly generate a list of all venues you use most often. Because this MCP lives within the Vinkius catalog, any compatible agent—whether it's in your IDE or your chat app—gets immediate access to everything Eventcube offers. You manage the entire lifecycle, from creating a new venue profile to tracking ticket sales, without ever leaving your conversation.

## Tools

### create_event
Sets up the basic data profile for a brand-new event.

### create_ticket
Defines and creates a new type of ticket that can be sold for an event.

### create_venue
Adds a completely new physical location or venue profile to the system.

### get_event
Retrieves all core details for one specific, existing event ID.

### get_me
Checks if your agent has proper access and confirms the account context.

### get_order
Pulls up the full details associated with a specific customer order ID.

### list_categories
Fetches a list of all event categories available in your account.

### list_events
Provides an overview and listing of every active or past event recorded in the system.

### list_orders
Generates a comprehensive list of all ticket orders placed by customers.

### list_tickets
Lists every single ticket associated with an event, useful for auditing or reporting.

### list_venues
Presents a list of all venue profiles you have saved in Eventcube.

### resend_order_confirmation
Triggers the system to send a duplicate confirmation email for a specific order.

## Prompt Examples

**Prompt:** 
```
List all active events in Eventcube.
```

**Response:** 
```
You have 2 active events: 'Summer Music Fest' (ID: 101) and 'Tech Conference 2024' (ID: 102).
```

**Prompt:** 
```
Check the ticket sales for event ID 101.
```

**Response:** 
```
Event 101 has sold 450 out of 500 total tickets. Only 50 remaining.
```

**Prompt:** 
```
Show the registration details for attendee 'john@example.com'.
```

**Response:** 
```
John Doe (john@example.com) is registered for 'Tech Conference 2024' with a VIP Pass. Registration is confirmed.
```

## Capabilities

### Review and Create Events
You can ask the system for details on any existing event or initiate the setup process by creating an entirely new one.

### Track Ticket Inventory and Sales
The MCP counts ticket sales against total capacity, lets you list tickets for a specific gathering, or even create brand new ticket types.

### Manage Venue Data
You can maintain your asset records by listing saved venues or setting up profiles for new locations.

### Process and Track Orders
It retrieves specific order details, lists all historical orders, or resends confirmation emails to attendees.

## Use Cases

### Checking Pre-Sale Capacity
A marketing manager needs to know if they can sell 500 tickets for a new event. They ask their agent, and the agent uses `list_events` to confirm no conflicting events are listed, then uses `get_event` to see current capacity limits.

### Handling Last-Minute Attendee Questions
A staff member needs to check if 'Jane Smith' bought a VIP pass. They prompt their agent with the attendee email, and the MCP runs `list_tickets` against that event ID to confirm her specific ticket type.

### Setting Up an Entire Day's Program
The ops team is planning a multi-day conference. They first use `create_venue` to define the main hall, then use `create_event` for each day, ensuring all related data points are logged correctly.

### Auditing Past Sales
The finance team needs a full record of last month's sales. They ask their agent to run `list_orders`, which compiles every transaction ID and order date into one readable list for review.

## Benefits

- Stop manually checking ticket totals. Use `list_tickets` or `get_event` to instantly know the exact number of tickets sold versus capacity for any gathering.
- Needing a new location? You can use `create_venue` to add a venue profile, then link that location to future events via `create_event`. It keeps your data organized.
- Handling customer service is easier. If someone asks about an old purchase, running `get_order` gives you the full transaction history instantly.
- Building out new campaigns? You can use `list_categories` and `list_events` together to quickly scope what kind of events your account supports.
- Got a customer who lost their receipt? Instead of calling them back, running `resend_order_confirmation` sends the details directly from your agent.

## How It Works

The bottom line is that it turns complex database lookups into simple conversational queries.

1. First, you tell your agent what data point you need—for example, 'Show me the total tickets sold for Event ID 101.'
2. The MCP processes this request by calling the relevant internal tool and fetching structured data from the Eventcube system.
3. Your agent gets back a plain language summary of the result, like '450 out of 500 tickets are sold,' without you needing to touch any backend dashboards.

## Frequently Asked Questions

**How do I check if an event has enough tickets using list_tickets?**
You use `list_tickets` first. This tool shows every available ticket type for a given event, letting you see the total count and how many are left in inventory.

**Can I find out what events were run last year using list_events?**
Yes, `list_events` provides an overview of all recorded gatherings. You filter the results by date or status to pull up historical data quickly.

**What if a customer needs their confirmation email sent again? Do I use resend_order_confirmation?**
That's exactly right. Running `resend_order_confirmation` takes an order ID and triggers the system to send the necessary receipt, saving you from manual support tasks.

**Is there a tool to set up my physical locations?**
Yes, use `create_venue` to add new spots. You can then keep track of all your assets by running `list_venues` at any time.

**How do I check my account access before running any commands, like using `get_me`?**
You use `get_me` to verify connectivity and pull your current account context. This confirms that your AI agent has the necessary permissions and is properly linked to Eventcube.

**What data do I need to provide when running the `create_venue` tool?**
When you use `create_venue`, you must supply key details like the venue name, physical address, and maximum capacity. Providing these specific fields ensures the new profile is accurate.

**If I know an event ID but not all its current data, how do I retrieve everything with `get_event`?**
`get_event` pulls a full snapshot of the specified event. You get back details including dates, location info, and overall ticket status for that particular ID.

**Before setting up an event, how do I see what kind of categories are available using `list_categories`?**
`list_categories` provides a list of all defined event types within Eventcube. This lets you ensure your new event falls under the correct category before creation.

**Can I check real-time ticket sales for an event?**
Yes, just supply the specific Event ID and the AI can query the exact number of sold and available tickets.

**Is it possible to retrieve an attendee's details?**
Absolutely. You can fetch attendee records to verify registration status or check their specific ticket type.

**Can I list all my active events?**
Yes, querying the list of active events will return their IDs, dates, and baseline capacities instantly.