MCP Server for Ticketmaster

A Model Context Protocol server that provides tools for discovering events, venues, and attractions through the Ticketmaster Discovery API.

Features

• Search for events, venues, and attractions with flexible filtering:
  • Keyword search
  • Date range for events
  • Location (city, state, country)
  • Venue-specific searches
  • Attraction-specific searches
  • Event classifications/categories
• Output formats:
  • Structured JSON data for programmatic use
  • Human-readable text for direct consumption
• Comprehensive data including:
  • Names and IDs
  • Dates and times (for events)
  • Price ranges (for events)
  • URLs
  • Images
  • Locations and addresses (for venues)
  • Classifications (for attractions)

Installation

Installing via Smithery

To install mcp-server-ticketmaster for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-ticketmaster --client claude

Manual Installation

npx -y install @delorenj/mcp-server-ticketmaster

Configuration

The server requires a Ticketmaster API key. You can get one by:

1. Going to https://developer.ticketmaster.com/

2. Creating an account or signing in

3. Going to "My Apps" in your account

4. Creating a new app to get your API key

Set your API key in your MCP settings file:

{
  "mcpServers": {
    "ticketmaster": {
      "command": "npx",
      "args": ["-y", "@delorenj/mcp-server-ticketmaster"],
      "env": {
        "TICKETMASTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage

The server provides a tool called `search_ticketmaster` that accepts:

Required Parameters

• `type`: Type of search ('event', 'venue', or 'attraction')

Optional Parameters

• `keyword`: Search term
• `startDate`: Start date in YYYY-MM-DD format (for events)
• `endDate`: End date in YYYY-MM-DD format (for events)
• `city`: City name
• `stateCode`: State code (e.g., 'NY')
• `countryCode`: Country code (e.g., 'US')
• `venueId`: Specific venue ID
• `attractionId`: Specific attraction ID
• `classificationName`: Event category (e.g., 'Sports', 'Music')
• `format`: Output format ('json' or 'text', defaults to 'json')

Examples

Structured JSON Output (Default)

ticketmaster
search_ticketmaster

{
  "type": "event",
  "keyword": "concert",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "New York",
  "stateCode": "NY"
}

Human-Readable Text Output

ticketmaster
search_ticketmaster

{
  "type": "event",
  "keyword": "concert",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "New York",
  "stateCode": "NY",
  "format": "text"
}

Development

1. Clone the repository

2. Copy the example environment file:

cp .env.example .env

3. Add your Ticketmaster API key to `.env`

4. Install dependencies:

npm install

5. Build the project:

npm run build

6. Test with the inspector:

npm run inspector

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

MIT License - see LICENSE file for details