📌Overview

Purpose: To provide tools for discovering events, venues, and attractions via the Ticketmaster Discovery API.

Overview: The MCP Server for Ticketmaster is a specialized server designed to interact with the Ticketmaster Discovery API, enabling users to efficiently search for various events, venues, and attractions with customizable filters and output formats.

Key Features:

Flexible Search Options: Allows users to perform keyword searches, filter by date ranges, locations, and specific venues or attractions, facilitating tailored event discovery.
Data Output Formats: Supports structured JSON data for programmatic access as well as human-readable text for easier interpretation, catering to a diverse range of user needs.
Comprehensive Information: Provides detailed information about events (like dates, price ranges), venues (locations, addresses), and attractions (classifications), ensuring users have access to rich, contextual data.

MCP Server for Ticketmaster

A Model Context Protocol server providing 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
- Locations and addresses (for venues)
- Classifications (for attractions)

Installation

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

Configuration

The server requires a Ticketmaster API key. Obtain one by visiting https://developer.ticketmaster.com/, creating an account or signing in, and creating a new app under "My Apps" 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)

<use_mcp_tool>
<server_name>ticketmaster</server_name>
<tool_name>search_ticketmaster</tool_name>
<arguments>
{
  "type": "event",
  "keyword": "concert",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "New York",
  "stateCode": "NY"
}
</arguments>
</use_mcp_tool>

Human-Readable Text Output

<use_mcp_tool>
<server_name>ticketmaster</server_name>
<tool_name>search_ticketmaster</tool_name>
<arguments>
{
  "type": "event",
  "keyword": "concert",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "New York",
  "stateCode": "NY",
  "format": "text"
}
</arguments>
</use_mcp_tool>

Development

Clone the repository
Copy the example environment file:
```
cp .env.example .env
```
Add your Ticketmaster API key to .env
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Test with the inspector:
```
npm run inspector
```

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, open an issue first to discuss.

License

MIT License - see LICENSE file for details