Skip to main content
Glama

Eventbrite Model Context Protocol (MCP) Server

Python Version MCP Spec License: MIT Tests

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.AsyncClient with 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.0

  • Data Validation & Schemas: pydantic>=2.0.0

  • Build 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 (create_venue, update_venue, get_venue).

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 (checkin_attendee), order histories, and organization payouts.

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, order_by=changed_desc delta sync, and indexed date-range queries (search_organization_events_by_date, sync_organization_events, get_cached_event_statistics).


Getting Started

Prerequisites

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

EVENTBRITE_PRIVATE_TOKEN

Yes

Eventbrite API v3 OAuth private token.

EVENTBRITE_API_KEY

Optional

Fallback alternative if EVENTBRITE_PRIVATE_TOKEN is not set.

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-mcp

2. Using the MCP CLI Runner

mcp run eventbrite/server.py

3. 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 tests

To 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.py

Project 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                     # Documentation

Contributing & 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 tools
cancel_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

    C2.9/5.0

    Scored across 87 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers