MCP Server for Ticketmaster Events

by delorenj
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for discovering events, venues, and attractions through the Ticketmaster Discovery API. Allows searching for events, venues, and attractions with flexible filtering by keyword, date range, location, venue, attraction, and event classifications/categories.

Servidor MCP para Ticketmaster

Un servidor de protocolo de contexto de modelo que proporciona herramientas para descubrir eventos, lugares y atracciones a través de la API de descubrimiento de Ticketmaster.

Características

  • Busque eventos, lugares y atracciones con filtros flexibles:
    • Búsqueda de palabras clave
    • Rango de fechas para eventos
    • Ubicación (ciudad, estado, país)
    • Búsquedas específicas del lugar
    • Búsquedas específicas de atracciones
    • Clasificaciones/categorías de eventos
  • Formatos de salida:
    • Datos JSON estructurados para uso programático
    • Texto legible para consumo directo
  • Datos completos que incluyen:
    • Nombres e identificaciones
    • Fechas y horarios (para eventos)
    • Rangos de precios (para eventos)
    • URL
    • Imágenes
    • Ubicaciones y direcciones (para lugares)
    • Clasificaciones (para atracciones)

Instalación

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

Configuración

El servidor requiere una clave API de Ticketmaster. Puedes obtenerla de la siguiente manera:

  1. Ir a https://developer.ticketmaster.com/
  2. Crear una cuenta o iniciar sesión
  3. Vaya a "Mis aplicaciones" en su cuenta
  4. Creando una nueva aplicación para obtener tu clave API

Establezca su clave API en su archivo de configuración MCP:

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

Uso

El servidor proporciona una herramienta llamada search_ticketmaster que acepta:

Parámetros requeridos

  • type : Tipo de búsqueda ('evento', 'lugar' o 'atracción')

Parámetros opcionales

  • keyword : término de búsqueda
  • startDate : Fecha de inicio en formato AAAA-MM-DD (para eventos)
  • endDate : Fecha de finalización en formato AAAA-MM-DD (para eventos)
  • city : Nombre de la ciudad
  • stateCode : código de estado (p. ej., 'NY')
  • countryCode : Código de país (por ejemplo, 'EE. UU.')
  • venueId : ID de lugar específico
  • attractionId : ID de atracción específica
  • classificationName : Categoría del evento (p. ej., 'Deportes', 'Música')
  • format : Formato de salida ('json' o 'texto', predeterminado 'json')

Ejemplos

Salida JSON estructurada (predeterminada)

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

Salida de texto legible para humanos

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

Desarrollo

  1. Clonar el repositorio
  2. Copie el archivo de entorno de ejemplo:
    cp .env.example .env
  3. Agregue su clave API de Ticketmaster a .env
  4. Instalar dependencias:
    npm install
  5. Construir el proyecto:
    npm run build
  6. Prueba con el inspector:
    npm run inspector

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Proporciona herramientas para descubrir eventos en el Madison Square Garden a través de la API de Ticketmaster, devolviendo datos estructurados con detalles del evento como nombre, fecha, precio y enlaces de compra de entradas.

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. Required Parameters
          2. Optional Parameters
          3. Examples
        2. Development
          1. Contributing
            1. License
              ID: u91gv8f3on