Ticketmaster MCP Server

What is Ticketmaster MCP Server about?

Enables flexible searching of Ticketmaster events, venues, and attractions with a variety of filters and returns results in either structured JSON or human‑readable text.

How to use Ticketmaster MCP Server?

1. Install the server (via Smithery or manually with npm).
2. Add your Ticketmaster API key to the MCP settings or a .env file.
3. Invoke the search_ticketmaster tool, specifying required type (event, venue, attraction) and any optional parameters such as keyword, date range, location, etc.
4. Choose the output format (json default or text).

Key Features

• Keyword, date‑range, and geographic filtering.
• Separate searches for events, venues, and attractions.
• Classification/category filtering for events.
• Dual output formats: JSON for programmatic consumption or plain text for direct reading.
• Returns comprehensive data: IDs, names, dates, price ranges, URLs, images, addresses, and classifications.

Use Cases

• Build event recommendation widgets for websites or apps.
• Power travel itineraries with venue and attraction details.
• Generate daily digests of upcoming concerts or sports matches.
• Integrate real‑time event data into chatbots or virtual assistants.
• Conduct market analysis on event trends by category or location.

FAQ

Q: Which environment variable holds the API key? A: TICKETMASTER_API_KEY.

Q: What values can type take? A: event, venue, or attraction.

Q: How do I get a Ticketmaster API key? A: Sign up at https://developer.ticketmaster.com/, create an app, and copy the generated key.

Q: Can I limit the number of results? A: The underlying Discovery API supports pagination; configure size and page parameters within the tool if needed.

Q: Is there a way to get only text output? A: Set the format argument to text.

Q: What command is used for installation? A: npx -y @delorenj/mcp-server-ticketmaster (or via Smithery).

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)

<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

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