Eventbrite MCP Server
Provides integration with the Eventbrite API v3 for managing events, organizations, venues, ticket classes, attendees, and orders, including event publishing, ticket inventory monitoring, attendee check-in, and financial payouts/transfers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Eventbrite MCP Server list my upcoming events and sold ticket counts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Eventbrite Model Context Protocol (MCP) Server
A production-ready Model Context Protocol (MCP) server providing deep, token-optimized integration with the Eventbrite API v3. Designed specifically for LLM agents, workflow orchestrators, and automated career fair / event management pipelines.
Visual Anchor & Overview
The server bridges LLMs directly to Eventbrite via FastMCP standard I/O transport, providing 84 fine-grained tools covering the complete event lifecycle. Responses are automatically filtered and pruned through token-efficient payload sanitizers to minimize LLM context window bloat while preserving essential IDs, timestamps, pricing objects, and attendee metadata.
┌─────────────────────────┐ StdIO (JSON-RPC) ┌──────────────────────────────────────┐
│ AI Agent / Claude / │ ◄──────────────────────────────► │ Eventbrite MCP Server │
│ Hermes / MCP Client │ │ (FastMCP Fast Tool Registry) │
└─────────────────────────┘ └──────────────────┬───────────────────┘
│ HTTPS
▼
┌──────────────────────────────────────┐
│ Eventbrite API v3 (REST) │
│ /users, /events, /attendees, etc. │
└──────────────────────────────────────┘Related MCP server: Etsy MCP Server
Features
87 Comprehensive MCP Tools: Full API v3 coverage across organizations, venues, draft/live events, ticket tiers, orders, check-ins, promo codes, reports, plus SQLite-backed custom date-range query extensions.
Custom Local Date-Range Search Engine: Fills Eventbrite API's gap by caching organization events in a local SQLite database with delta sync (
order_by=changed_desc) to execute lightning-fast date-range queries (2025 to 2026).Modular Domain Architecture: Isolated tool modules (
users_orgs,events,ticketing,attendees_orders,discounts_webhooks,media_catalog,custom) for maintainability.Token-Efficient Payload Pruning: Strips bloated repetitive fields and normalizes paginated responses so LLMs receive dense, context-optimized JSON.
Live Venue Check-In & Attendee Tracking: Real-time barcode inspection, custom survey question retrieval, and venue attendee check-ins.
Full Ticketing & Capacity Controls: Manage free/paid admission packages, inventory tiers, ticket groups, and buyer checkout policies.
Robust Async Client: Built on
httpx.AsyncClientwith centralized Bearer token management, standard timeout configurations, and informative error handling.
Tech Stack
Language & Runtime: Python 3.11+
Protocol Framework: FastMCP (
mcp>=1.0.0,<2)HTTP Client:
httpx>=0.27.0Data Validation & Schemas:
pydantic>=2.0.0Build Backend:
hatchling
Tool Catalog Summary (84 Tools)
Domain | Count | Key Capabilities |
Users, Organizations & Venues | 10 | Profile inspection, organization listing, team member roles, and full venue CRUD operations ( |
Event Lifecycle & Scheduling | 21 | Event search, create draft, publish/unpublish, cancel, clone, delete, series/schedules, and group registration teams. |
Ticketing, Inventory & Settings | 17 | Free & paid ticket classes, on-sale filters, inventory tiers, ticket groups, capacity tiers, and buyer checkout settings. |
Attendees, Orders & Check-ins | 9 | Attendee registration lookups, barcode details, live check-ins ( |
Promotions, Questions & Webhooks | 14 | Access/discount code management, custom & canned survey questions, and organization/user webhook subscription lifecycle. |
Media, Taxonomy & Reports | 13 | Category/subcategory taxonomies, format types, S3 media upload tokens, sales reports, attendee reports, and event display settings. |
Custom Local Date Queries & Sync | 3 | High-speed local SQLite cache, |
Getting Started
Prerequisites
Python:
3.11or higherEventbrite Account & Private Token: Generate an API token from your Eventbrite Developer Account.
Installation
Clone the repository and install dependencies in editable mode:
git clone https://github.com/stalinyang/eventbrite-mcp-server.git
cd eventbrite-mcp-server
# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install package dependencies
pip install -e .Environment Variables
Configure your credentials via environment variables or a .env file:
Variable | Required | Description |
| Yes | Eventbrite API v3 OAuth private token. |
| Optional | Fallback alternative if |
export EVENTBRITE_PRIVATE_TOKEN="your_eventbrite_private_token"Usage / Quickstart
1. Direct Stdio Execution
Run the server directly via standard I/O:
python -m eventbrite.server
# or use the registered console entrypoint
eventbrite-mcp2. Using the MCP CLI Runner
mcp run eventbrite/server.py3. Integrating with Hermes Agent or Claude Desktop
Add the server definition to your MCP client configuration (e.g., ~/.hermes/config.yaml or Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"eventbrite": {
"command": "/path/to/eventbrite-mcp-server/.venv/bin/python",
"args": ["-m", "eventbrite.server"],
"env": {
"EVENTBRITE_PRIVATE_TOKEN": "YOUR_PRIVATE_TOKEN"
}
}
}
}Development & Testing
The repository includes a comprehensive unit test suite verifying tool registrations, parameter schemas, mock HTTP transports, and error handling.
Run all tests via Python's standard unittest runner:
python -m unittest discover testsTo run individual test modules:
python -m unittest tests/test_coverage.py
python -m unittest tests/test_server.py
python -m unittest tests/test_mock_tools.pyProject Structure
eventbrite-mcp-server/
├── eventbrite/
│ ├── __init__.py # Package exports (mcp, main)
│ ├── client.py # Async httpx client & error handling
│ ├── server.py # FastMCP application setup & registry
│ ├── utils.py # Token-saving payload pruning & sanitizers
│ └── tools/
│ ├── attendees_orders.py # Attendees, check-ins, orders & payouts
│ ├── discounts_webhooks.py # Promo codes, custom questions & webhooks
│ ├── events.py # Event lifecycle, recurring schedules & teams
│ ├── media_catalog.py # Categories, formats, upload tokens & reports
│ ├── ticketing.py # Ticket classes, inventory tiers & checkout settings
│ └── users_orgs.py # Profiles, organizations & venues
├── tests/
│ ├── test_coverage.py # Domain-wide dispatch tests
│ ├── test_mock_tools.py # Individual tool mock execution
│ └── test_server.py # FastMCP endpoint tests
├── .env.example # Sample environment variable template
├── pyproject.toml # Project packaging & script definitions
└── README.md # DocumentationContributing & License
Contributions, issue reports, and pull requests are welcome. Please ensure all unit tests pass prior to submitting PRs.
This project is licensed under the MIT License.
Available Tools
87 toolscancel_eventC
Cancel an event on Eventbrite.
Inputs: event_id (required). Returns: result
checkin_attendeeC
Check in an attendee at the event.
Inputs: event_id (required), attendee_id (required). Returns: result
copy_eventB
Clone/copy an existing event into a new draft event.
Inputs: event_id (required). Returns: result
create_eventA
Create a new draft event under an organization. Timestamps must be UTC strings in format: YYYY-MM-DDTHH:MM:SSZ
Inputs: name (required), end_utc (required), start_utc (required), organization_id (required), +8 more. Returns: result
create_event_inventory_tierB
Create a new inventory tier for an event.
Inputs: name (required), event_id (required), quantity_total (required), count_against_event_capacity. Returns: result
create_event_questionB
Create a registration question for an event. type: 'text', 'multichoice', 'checkbox', 'radio'
Inputs: type (required), event_id (required), question_text (required), choices, +2 more. Returns: result
create_event_scheduleC
Create a recurring event schedule. recurrence_rule: iCalendar RRULE format (e.g. 'FREQ=WEEKLY;COUNT=10')
Inputs: event_series_id (required), recurrence_rule (required), occurrence_duration_seconds (required). Returns: result
create_event_teamB
Create a new team for an event.
Inputs: name (required), event_id (required). Returns: result
create_organization_discountC
Create a discount or access code for an organization or event. type: 'access', 'coded', 'hold', 'public'
Inputs: code (required), type (required), organization_id (required), value, +7 more. Returns: result
create_organization_ticket_groupC
Create a ticket group under an organization.
Inputs: name (required), organization_id (required), status, ticket_class_ids. Returns: result
create_organization_webhookB
Create a webhook endpoint for an organization. actions: comma-separated list like 'order.placed,attendee.checked_in,event.published'
Inputs: actions (required), endpoint_url (required), organization_id (required), event_id. Returns: result
create_ticket_classC
Create a ticket class for an event (free admission or paid tier).
Inputs: name (required), event_id (required), quantity_total (required), free, +5 more. Returns: result
create_venueB
Create a new venue (hotel, convention hall, office) under an organization.
Inputs: city (required), name (required), region (required), address_1 (required), +5 more. Returns: result
delete_discountC
Delete a discount code.
Inputs: discount_id (required). Returns: result
delete_eventC
Delete an event by ID.
Inputs: event_id (required). Returns: result
delete_event_inventory_tierC
Delete an inventory tier from an event.
Inputs: event_id (required), inventory_tier_id (required). Returns: result
delete_event_questionC
Delete a custom registration question.
Inputs: event_id (required), question_id (required). Returns: result
delete_ticket_groupC
Delete a ticket group.
Inputs: ticket_group_id (required). Returns: result
delete_webhookC
Delete a webhook by ID.
Inputs: webhook_id (required). Returns: result
get_attendee_detailsB
Retrieve full attendee profile, barcode, and custom question answers.
Inputs: event_id (required), attendee_id (required). Returns: result
get_attendees_reportC
Retrieve attendee summary report for one or more event IDs (comma-separated).
Inputs: event_ids (required), filter_by. Returns: result
get_cached_event_statisticsA
Retrieve aggregate event statistics (events count by status, by year, and by top cities) from local SQLite cache.
Inputs: organization_id (required), year. Returns: result
get_categoryB
Get details and subcategories for a specific category ID.
Inputs: category_id (required). Returns: result
get_current_userA
Retrieve profile and email details of the authenticated Eventbrite user account.
Inputs: no named parameters. Returns: result
get_discountA
Get details of a specific promotional discount or access code.
Inputs: discount_id (required). Returns: result
get_eventB
Get details for a specific event including status, schedule, venue, and capacity.
Inputs: event_id (required). Returns: result
get_event_capacity_tierC
Get capacity configuration and tier count for an event.
Inputs: event_id (required). Returns: result
get_event_descriptionA
Get the full description HTML and text for an event.
Inputs: event_id (required). Returns: result
get_event_display_settingsB
Get display settings for an event page (show start/end time, show organizer info, etc.).
Inputs: event_id (required). Returns: result
get_event_inventory_tierC
Get details of a specific inventory tier.
Inputs: event_id (required), inventory_tier_id (required). Returns: result
get_event_questionA
Retrieve details of a registration question.
Inputs: event_id (required), question_id (required). Returns: result
get_event_seriesC
Get information about an event series.
Inputs: event_series_id (required). Returns: result
get_event_teamB
Retrieve details of a specific team in an event.
Inputs: team_id (required), event_id (required). Returns: result
get_fee_ratesB
Get current Eventbrite fee rates and calculation rules for a country and currency.
Inputs: country, currency. Returns: result
get_formatB
Get details of a specific event format.
Inputs: format_id (required). Returns: result
get_mediaA
Retrieve details and download URLs of uploaded media (images, banners).
Inputs: media_id (required). Returns: result
get_media_upload_instructionsA
Get an upload token and S3 post parameters for uploading an image to Eventbrite. type: 'image-event-logo', 'image-event-description'
Inputs: type. Returns: result
get_orderB
Retrieve details of an order including purchaser info, status, and financial totals.
Inputs: order_id (required). Returns: result
get_sales_reportB
Retrieve sales report summary for one or more event IDs (comma-separated). filter_by: 'event' or 'date'
Inputs: event_ids (required), filter_by. Returns: result
get_subcategoryC
Get details for a specific subcategory.
Inputs: subcategory_id (required). Returns: result
get_ticket_buyer_settingsB
Get ticket checkout buyer settings for an event.
Inputs: event_id (required). Returns: result
get_ticket_classB
Get details of a specific ticket class.
Inputs: event_id (required), ticket_class_id (required). Returns: result
get_ticket_groupC
Retrieve details of a ticket group.
Inputs: ticket_group_id (required). Returns: result
get_user_by_idB
Retrieve public details of an Eventbrite user by user ID.
Inputs: user_id (required). Returns: result
get_venueA
Retrieve details of a venue by venue ID (address, capacity, coordinates).
Inputs: venue_id (required). Returns: result
list_categoriesC
List standard Eventbrite event categories.
Inputs: continuation. Returns: result
list_event_attendeesB
List attendees registered for an event with profile, barcode, and answer fields. status options: 'attending', 'not_attending', 'unpaid'
Inputs: event_id (required), status, continuation, changed_since. Returns: result
list_event_canned_questionsA
List standard canned questions (Job Title, Company, Address, etc.) for an event.
Inputs: event_id (required). Returns: result
list_event_inventory_tiersC
List inventory tiers configured for an event.
Inputs: event_id (required), continuation. Returns: result
list_event_ordersC
List ticket orders and buyer profiles for a specific event.
Inputs: event_id (required), status, continuation, changed_since. Returns: result
list_event_questionsB
List custom registration questions configured for an event.
Inputs: event_id (required), continuation. Returns: result
list_event_team_attendeesC
List attendees who belong to a specific team.
Inputs: team_id (required), event_id (required), continuation. Returns: result
list_event_teamsB
List group registration teams for an event.
Inputs: event_id (required), continuation. Returns: result
list_formatsA
List event format types (e.g., Conference, Expo, Seminar, Networking).
Inputs: no named parameters. Returns: result
list_organization_attendeesC
List attendees across all events in an organization.
Inputs: organization_id (required), status, continuation, changed_since. Returns: result
list_organization_discountsC
List promotional discounts and access codes under an organization. scope: 'event' or 'organization'
Inputs: organization_id (required), code, scope, continuation. Returns: result
list_organization_eventsC
List events for an organization. status options: 'live', 'draft', 'canceled', 'ended', 'all'
Inputs: organization_id (required), status, order_by, continuation. Returns: result
list_organization_membersC
List team members and staff associated with an organization.
Inputs: organization_id (required), continuation. Returns: result
list_organization_ordersB
List orders across all events in an organization.
Inputs: organization_id (required), status, continuation, changed_since. Returns: result
list_organization_payoutsB
List financial payouts and bank transfers for an organization.
Inputs: organization_id (required), continuation. Returns: result
list_organization_rolesA
List permission roles configured in an organization.
Inputs: organization_id (required). Returns: result
list_organizations_for_userC
List organizations accessible by a specific user ID.
Inputs: user_id (required). Returns: result
list_organization_ticket_groupsA
List ticket groups configured under an organization.
Inputs: organization_id (required), continuation. Returns: result
list_organization_venuesA
List all venues configured under an organization.
Inputs: organization_id (required), continuation. Returns: result
list_organization_webhooksB
List active webhooks configured for an organization.
Inputs: organization_id (required), continuation. Returns: result
list_series_eventsC
List individual event occurrences belonging to an event series.
Inputs: event_series_id (required), continuation. Returns: result
list_subcategoriesC
List Eventbrite subcategories.
Inputs: continuation. Returns: result
list_ticket_classesB
List all ticket classes (admissions, VIP, booth packages) for an event.
Inputs: event_id (required), continuation. Returns: result
list_ticket_classes_for_saleC
List currently on-sale ticket classes for an event.
Inputs: event_id (required), continuation. Returns: result
list_user_ordersA
List ticket purchase orders made by a specific user account.
Inputs: user_id (required), continuation. Returns: result
list_user_organizationsA
List all organizations that the authenticated user belongs to or manages.
Inputs: no named parameters. Returns: result
list_user_webhooksA
List webhooks configured on the current user account.
Inputs: continuation. Returns: result
list_venue_eventsC
List events scheduled at a specific venue.
Inputs: venue_id (required), status, continuation. Returns: result
publish_eventA
Publish a draft event, making it live for attendee registrations.
Inputs: event_id (required). Returns: result
search_eventsB
Search public events by keyword, location, or distance.
Inputs: q, continuation, location_within, location_address. Returns: result
search_organization_events_by_dateA
Search organization events within an exact UTC date range (e.g. 2025-01-01T00:00:00Z to 2026-12-31T23:59:59Z). Uses local SQLite index with automatic delta sync if cache is older than auto_sync_if_stale_minutes.
Inputs: end_date_utc (required), start_date_utc (required), organization_id (required), city, +5 more. Returns: result
sync_organization_eventsA
Synchronize events from Eventbrite API into the local SQLite database. Runs full backfill if new, or fast incremental delta sync via 'changed_desc'.
Inputs: organization_id (required), force_full_resync. Returns: result
unpublish_eventC
Unpublish a live event, taking it offline.
Inputs: event_id (required). Returns: result
update_discountC
Update an existing discount or promotional code.
Inputs: discount_id (required), code, end_date, amount_off, +2 more. Returns: result
update_eventC
Update an existing event's details.
Inputs: event_id (required), name, end_utc, summary, +4 more. Returns: result
update_event_capacity_tierC
Update total capacity limit for an event.
Inputs: event_id (required), capacity_total (required). Returns: result
update_event_display_settingsB
Update display settings for an event page.
Inputs: event_id (required), show_end_time, show_start_time. Returns: result
update_event_inventory_tierC
Update an existing inventory tier.
Inputs: event_id (required), inventory_tier_id (required), name, quantity_total. Returns: result
update_ticket_buyer_settingsB
Update checkout settings (refund policy, checkout time limit) for an event.
Inputs: event_id (required), refund_policy, checkout_time_limit. Returns: result
update_ticket_classC
Update an existing ticket class.
Inputs: event_id (required), ticket_class_id (required), name, currency, +3 more. Returns: result
update_ticket_groupC
Update a ticket group.
Inputs: ticket_group_id (required), name, status. Returns: result
update_venueC
Update an existing venue's details.
Inputs: venue_id (required), city, name, region, +4 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 87 tools
Most tools target a distinct resource plus action, making them easy to tell apart across events, venues, orders, discounts, attendees, and reports. A few near-overlaps exist, such as list_user_organizations versus list_organizations_for_user and capacity tier versus inventory tier, but the descriptions are sufficient to disambiguate them.
The naming convention is predominantly verb_noun and very predictable, e.g. create_event, get_event, update_event, delete_event. Minor deviations such as checkin_attendee, list_user_organizations versus list_organizations_for_user, and create_organization_discount versus delete_discount prevent a perfect score.
With 87 tools, this server is far beyond the recommended MCP tool surface and creates significant selection overhead. Even for a comprehensive Eventbrite API integration, this is an extreme number of tools that will make agent routing more difficult.
The tool surface covers the primary Eventbrite lifecycle comprehensively, including events, venues, ticket classes, inventory tiers, discounts, orders, attendees, webhooks, questions, media, and reports. Minor gaps like missing delete for ticket classes and venues, and no update for event questions, are workaroundable and do not break core workflows.
Maintenance
Related MCP Connectors
Manage Eventbrite events, ticket classes, venues and discounts; read attendees, orders and reports.
Event ticketing: create and publish events, read orders, attendees and sales analytics.
Read Eventzilla events, tickets, orders, attendees and users; open or close ticket sales.
Read and manage your EventDorm events, sales, attendees, and check-ins.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIntegrates with the Eventbrite API to provide AI-assisted event management capabilities for viewing events, tracking attendees, and generating analytics reports.3MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables seamless integration with Etsy's marketplace API v3 to search listings, manage shop inventory, create and update products, optimize SEO, and access seller resources with OAuth support for authenticated operations.5-
- AlicenseBqualityDmaintenanceEnables natural language access to the Eventbrite API for creating, managing, and interacting with events, venues, and categories.136 npm4MIT
- FlicenseNot gradedqualityDmaintenanceFull MCP server for the Eventbrite API with 73 tools to manage events, attendees, orders, tickets, venues, discounts, reports, webhooks, and more.-