DM

delorenj/mcp-server-ticketmaster

Developer tools
25 stars 0 forks 품질 99 트렌드 99

A Ticketmaster MCP server that provides query capabilites from the Discovery API

개요

A Model Context Protocol server that provides tools for discovering events, venues, and attractions through the Ticketmaster Discovery API. - 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) To install mcp-server-ticketmaster for Claude Desktop automatically via Smithery: 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.

README

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

View this README on GitHub

설치

npx -y @delorenj/mcp-server-ticketmaster

설정

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