Ticketmaster
Created 6 months ago
A Model Context Protocol server that provides tools for discovering events, venues, and attractions through the Ticketmaster Discovery API.
What is Ticketmaster?
Search for events, venues, and attractions through the Ticketmaster Discovery API
Documentation
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
```\n\n### Manual Installation
```bash
npx -y install @delorenj/mcp-server-ticketmaster
Configuration
The server requires a Ticketmaster API key. You can get one by:
- Going to https://developer.ticketmaster.com/
- Creating an account or signing in
- Going to "My Apps" in your account
- 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:\n\n### Required Parameters
type: Type of search ('event', 'venue', or 'attraction')\n\n### Optional Parameterskeyword: Search termstartDate: Start date in YYYY-MM-DD format (for events)endDate: End date in YYYY-MM-DD format (for events)city: City namestateCode: State code (e.g., 'NY')countryCode: Country code (e.g., 'US')venueId: Specific venue IDattractionId: Specific attraction IDclassificationName: Event category (e.g., 'Sports', 'Music')format: Output format ('json' or 'text', defaults to 'json')\n\n### 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"
}
```\n\n#### Human-Readable Text Output
```json
ticketmaster search_ticketmaster {
"type": "event",
"keyword": "concert",
"startDate": "2025-02-01",
"endDate": "2025-02-28",
"city": "New York",
"stateCode": "NY",
"format": "text"
}
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, please open an issue first to discuss what you would like to change.
License
MIT License - see LICENSE file for details
Server Config
{
"mcpServers": {
"ticketmaster-server": {
"command": "npx",
"args": [
"ticketmaster"
]
}
}
}