@prmichaelsen/eventbrite-mcp 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -60
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,22 @@
|
|
|
1
1
|
# @prmichaelsen/eventbrite-mcp
|
|
2
2
|
|
|
3
|
-
An MCP (Model Context Protocol) server that provides event management and ticketing capabilities through the Eventbrite API.
|
|
3
|
+
An MCP (Model Context Protocol) server that provides comprehensive event management and ticketing capabilities through the Eventbrite API v3.
|
|
4
|
+
|
|
5
|
+
> Note: Not every tool in this repository has been tested. Ticket creation workflow is supported. If other tools fail, please create an issue for that tool.
|
|
4
6
|
|
|
5
7
|
## Features
|
|
6
8
|
|
|
7
|
-
- **Event Management**:
|
|
8
|
-
- **Ticket Management**: Create and manage ticket classes
|
|
9
|
-
- **
|
|
10
|
-
- **
|
|
11
|
-
- **
|
|
9
|
+
- **Event Management**: Create, update, publish, delete, cancel, and copy events
|
|
10
|
+
- **Ticket Management**: Create, update, and manage ticket classes
|
|
11
|
+
- **Order Management**: Retrieve and list orders
|
|
12
|
+
- **Attendee Management**: Get and list attendee information
|
|
13
|
+
- **Organization Support**: Manage organizations, venues, and members
|
|
14
|
+
- **Discount Management**: Create and manage discount codes
|
|
15
|
+
- **Media & Content**: Upload media and manage structured content
|
|
16
|
+
- **Webhooks**: Create and manage webhooks
|
|
17
|
+
- **Categories & Formats**: Access event categories and formats
|
|
18
|
+
- **Inventory Management**: Manage inventory tiers
|
|
19
|
+
- **And more**: 42 tools total - see [`./src/tools`](./src/tools) for complete list
|
|
12
20
|
|
|
13
21
|
## Installation
|
|
14
22
|
|
|
@@ -61,41 +69,7 @@ Add to your MCP client configuration (e.g., Claude Desktop, Kilo Code):
|
|
|
61
69
|
}
|
|
62
70
|
```
|
|
63
71
|
|
|
64
|
-
##
|
|
65
|
-
|
|
66
|
-
### list_events
|
|
67
|
-
|
|
68
|
-
List events from Eventbrite with optional filtering.
|
|
69
|
-
|
|
70
|
-
**Parameters:**
|
|
71
|
-
- `organizationId` (optional): Filter events by organization ID
|
|
72
|
-
- `status` (optional): Filter by status (draft, live, started, ended, completed, canceled, all)
|
|
73
|
-
- `orderBy` (optional): Order results (start_asc, start_desc, created_asc, created_desc)
|
|
74
|
-
- `pageSize` (optional): Number of results per page (1-50, default: 50)
|
|
75
|
-
- `continuation` (optional): Pagination token
|
|
76
|
-
|
|
77
|
-
**Example:**
|
|
78
|
-
```typescript
|
|
79
|
-
{
|
|
80
|
-
"status": "live",
|
|
81
|
-
"orderBy": "start_asc",
|
|
82
|
-
"pageSize": 10
|
|
83
|
-
}
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### get_event
|
|
87
|
-
|
|
88
|
-
Get detailed information about a specific event.
|
|
89
|
-
|
|
90
|
-
**Parameters:**
|
|
91
|
-
- `eventId` (required): The ID of the event
|
|
92
|
-
|
|
93
|
-
**Example:**
|
|
94
|
-
```typescript
|
|
95
|
-
{
|
|
96
|
-
"eventId": "123456789"
|
|
97
|
-
}
|
|
98
|
-
```
|
|
72
|
+
## Tool Examples
|
|
99
73
|
|
|
100
74
|
### create_event
|
|
101
75
|
|
|
@@ -128,6 +102,31 @@ Create a new event on Eventbrite.
|
|
|
128
102
|
}
|
|
129
103
|
```
|
|
130
104
|
|
|
105
|
+
### update_event
|
|
106
|
+
|
|
107
|
+
Update an existing event by event ID. Supports partial updates.
|
|
108
|
+
|
|
109
|
+
**Parameters:**
|
|
110
|
+
- `event_id` (required): Event ID
|
|
111
|
+
- `name` (optional): Event name object with html property
|
|
112
|
+
- `summary` (optional): Event summary
|
|
113
|
+
- `start` (optional): Start datetime with timezone and utc
|
|
114
|
+
- `end` (optional): End datetime with timezone and utc
|
|
115
|
+
- `currency` (optional): Currency code
|
|
116
|
+
- `online_event` (optional): Is online only
|
|
117
|
+
- `listed` (optional): Publicly searchable
|
|
118
|
+
- Plus 20+ additional optional fields
|
|
119
|
+
|
|
120
|
+
**Example:**
|
|
121
|
+
```typescript
|
|
122
|
+
{
|
|
123
|
+
"event_id": "123456789",
|
|
124
|
+
"name": { "html": "Updated Conference Name" },
|
|
125
|
+
"summary": "New event description",
|
|
126
|
+
"listed": true
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|
|
131
130
|
### create_ticket_class
|
|
132
131
|
|
|
133
132
|
Create a ticket class for an event.
|
|
@@ -156,25 +155,41 @@ Create a ticket class for an event.
|
|
|
156
155
|
}
|
|
157
156
|
```
|
|
158
157
|
|
|
159
|
-
###
|
|
158
|
+
### publish_event
|
|
160
159
|
|
|
161
|
-
|
|
160
|
+
Publish an event to make it live and available for ticket sales.
|
|
162
161
|
|
|
163
162
|
**Parameters:**
|
|
164
|
-
- `
|
|
165
|
-
- `status` (optional): Filter by status (attending, not_attending, unpaid)
|
|
166
|
-
- `pageSize` (optional): Results per page (1-50, default: 50)
|
|
167
|
-
- `continuation` (optional): Pagination token
|
|
163
|
+
- `event_id` (required): Event ID
|
|
168
164
|
|
|
169
165
|
**Example:**
|
|
170
166
|
```typescript
|
|
171
167
|
{
|
|
172
|
-
"
|
|
173
|
-
"status": "attending",
|
|
174
|
-
"pageSize": 50
|
|
168
|
+
"event_id": "123456789"
|
|
175
169
|
}
|
|
176
170
|
```
|
|
177
171
|
|
|
172
|
+
## All Available Tools
|
|
173
|
+
|
|
174
|
+
For a complete list of all 42 supported tools, please see [`./src/tools`](./src/tools) directory.
|
|
175
|
+
|
|
176
|
+
**Tool Categories:**
|
|
177
|
+
- Events (9 tools)
|
|
178
|
+
- Tickets (4 tools)
|
|
179
|
+
- Orders (2 tools)
|
|
180
|
+
- Attendees (2 tools)
|
|
181
|
+
- Organizations (3 tools)
|
|
182
|
+
- Venues (4 tools)
|
|
183
|
+
- Discounts (5 tools)
|
|
184
|
+
- Categories & Formats (6 tools)
|
|
185
|
+
- Webhooks (3 tools)
|
|
186
|
+
- Media & Content (4 tools)
|
|
187
|
+
- Inventory Tiers (5 tools)
|
|
188
|
+
- Display Settings (2 tools)
|
|
189
|
+
- Questions (3 tools)
|
|
190
|
+
- User (1 tool)
|
|
191
|
+
- API Documentation (1 tool)
|
|
192
|
+
|
|
178
193
|
## Development
|
|
179
194
|
|
|
180
195
|
### Setup
|
|
@@ -202,18 +217,10 @@ eventbrite-mcp/
|
|
|
202
217
|
│ ├── server.ts # Main MCP server
|
|
203
218
|
│ ├── eventbrite/
|
|
204
219
|
│ │ └── client.ts # Eventbrite API client
|
|
205
|
-
│ ├── tools/ # MCP tool implementations
|
|
206
|
-
│ │ ├── list-events.ts
|
|
207
|
-
│ │ ├── get-event.ts
|
|
208
|
-
│ │ ├── create-event.ts
|
|
209
|
-
│ │ ├── create-ticket-class.ts
|
|
210
|
-
│ │ └── list-attendees.ts
|
|
220
|
+
│ ├── tools/ # MCP tool implementations (42 tools)
|
|
211
221
|
│ ├── types/ # TypeScript type definitions
|
|
212
|
-
│ │ ├── eventbrite.ts
|
|
213
|
-
│ │ └── mcp.ts
|
|
214
222
|
│ └── utils/ # Utility functions
|
|
215
|
-
|
|
216
|
-
│ └── error-serializer.ts
|
|
223
|
+
├── agent/ # Development documentation
|
|
217
224
|
├── package.json
|
|
218
225
|
├── tsconfig.json
|
|
219
226
|
└── README.md
|