Delorenj MCP Server Ticketmaster

🚀 Ticketmaster's MCP Server

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

✨ Features

• Flexible filtering options when searching for events, venues, and attractions:
  • Keyword search
  • Event date range
  • Geographical location (city, state, country)
  • Search for specific venues
  • Search for specific attractions
  • Event classification/category
• Output formats:
  • Structured JSON data for programming
  • Readable text for direct use
• Comprehensive data includes:
  • Name and ID
  • Date and time (for events)
  • Price range (for events)
  • URL
  • Location and address (for venues)
  • Classification (for attractions)

📦 Installation

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

🛠️ Configuration

This server requires a Ticketmaster API key. You can obtain it by following these steps:

1. Visit https://developer.ticketmaster.com/
2. Create an account or log in
3. Go to "My Apps" in your account
4. Create 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 Examples

Basic Usage

The server provides a tool named search_ticketmaster that accepts the following parameters:

Required Parameters

• type: Search type ('event', 'venue', or 'attraction')

Optional Parameters

• keyword: Search term
• startDate: Start date in the format YYYY-MM-DD (for events)
• endDate: End date in the format YYYY-MM-DD (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', default is 'json')

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>

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 checker:

   npm run check
   

🤝 Contribution

Contributions to this project are welcome! Please check the Contribution Guidelines for more information.

📄 License

This project is protected under the MIT License.