Eventbrite MCP Server

A Model Context Protocol (MCP) server for Eventbrite event management, reporting, and analytics.

Project Overview

This MCP server integrates with the Eventbrite API to provide tools for managing events, tracking attendees, and generating analytics reports. It's designed to work with Claude and other MCP clients to provide AI-assisted event management capabilities.

Project Status

Status	Description
🚧 In Progress	Basic functionality implemented

Currently, the following tools are implemented:

• list_events: List events with optional filtering
• get_event_details: Get detailed information about a specific event

Features

• Event Management: View, create, update, and publish events
• Attendee Management: List attendees, view details, and export attendee data
• Sales Analytics: Generate reports on ticket sales, revenue, and trends
• Custom Reports: Create and save custom reporting templates
• Data Visualization: Generate charts and graphs for key metrics

Implementation Plan

Phase 1: Setup & Core Infrastructure

• [x] Initialize project structure
• [x] Set up MCP server framework
• [x] Implement Eventbrite API authentication
• [x] Create basic API wrapper functions

Phase 2: Event Management Tools

• [x] Implement list_events tool
• [x] Implement get_event_details tool
• [ ] Implement create_event tool
• [ ] Implement update_event tool
• [ ] Implement publish_event tool

Phase 3: Attendee Management Tools

• [ ] Implement list_attendees tool
• [ ] Implement get_attendee_details tool
• [ ] Implement export_attendee_data tool

Phase 4: Analytics & Reporting

• [ ] Implement generate_sales_report tool
• [ ] Implement generate_attendance_report tool
• [ ] Implement generate_analytics_chart tool
• [ ] Create data visualization components

Phase 5: Testing & Documentation

• [x] Implement test MCP client
• [x] Create events viewer web interface
• [x] Comprehensive testing of event listing functionality
• [ ] Create comprehensive usage documentation
• [ ] Create example workflows

Development Log

Date	Description	Status
2025-03-20	Project planning initiated	Completed
2025-03-20	Reviewed Eventbrite API documentation	Completed
2025-03-20	Reviewed MCP server implementation examples	Completed
2025-03-20	Created initial project documentation	Completed
2025-03-20	Implemented core MCP server structure	Completed
2025-03-20	Implemented Eventbrite API client	Completed
2025-03-20	Implemented list_events and get_event_details tools	Completed
2025-03-20	Created test MCP client	Completed
2025-03-20	Implemented events viewer UI	Completed
2025-03-20	Tested event retrieval with date filtering	Completed

Getting Started

Prerequisites

• Node.js (v18 or higher)
• Eventbrite API token (private token from your Eventbrite account)
• Claude Desktop or other MCP client

Installation

# Clone the repository
git clone https://github.com/yourusername/eventbrite-mcp.git

# Install dependencies
cd eventbrite-mcp
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your Eventbrite API token

# Build the project
npm run build

# Start the server
npm start

Getting Your Eventbrite API Token

1. Log in to your Eventbrite account
2. Go to Account Settings > Developer Links > API Keys
3. Copy your private token
4. Add it to your .env file as EVENTBRITE_API_KEY=your_token_here

Configuration with Claude Desktop

Add the following to your claude_desktop_config.json (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

Option 1: Using npm start

{
  "mcpServers": {
    "eventbrite": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Option 2: Direct Node.js execution (recommended)

{
  "mcpServers": {
    "eventbrite": {
      "command": "node",
      "args": ["/path/to/eventbrite-mcp/dist/index.js"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Testing and Event Viewer

This project includes tools for testing the MCP server and viewing events:

Test MCP Client

The test-mcp-client-final.js script allows you to test the MCP server's event retrieval functionality:

# Run the test client with default parameters
node test-mcp-client-final.js

# Run with custom date range
node test-mcp-client-final.js --start-date="2025-01-01" --end-date="2025-12-31"

# Run with specific status filter
node test-mcp-client-final.js --status="live"

Events Viewer

The project includes a web-based events viewer for displaying and filtering events:

# Start the events viewer
node view-events.js

This will start a local web server and open the events viewer in your browser. The viewer allows you to:

• View all events retrieved from Eventbrite
• Filter events by date range
• Filter events by status
• View detailed event information

If the events.json file doesn't exist, the script will automatically fetch events from the Eventbrite API.

License

MIT