Ticketmaster

Descubre eventos, lugares y atracciones usando la API Discovery de Ticketmaster.

Documentación

Servidor MCP para Ticketmaster

Un servidor de Model Context Protocol que proporciona herramientas para descubrir eventos, recintos y atracciones a través de la API de Discovery de Ticketmaster.

Características

Búsqueda de eventos, recintos y atracciones con filtrado flexible:
- Búsqueda por palabra clave
- Rango de fechas para eventos
- Ubicación (ciudad, estado, país)
- Búsquedas específicas por recinto
- Búsquedas específicas por atracción
- 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 IDs
- Fechas y horas (para eventos)
- Rangos de precios (para eventos)
- URLs
- Imágenes
- Ubicaciones y direcciones (para recintos)
- Clasificaciones (para atracciones)

Instalación

Instalación mediante Smithery

Para instalar mcp-server-ticketmaster para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install mcp-server-ticketmaster --client claude

Instalación manual

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

Configuración

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

Yendo a https://developer.ticketmaster.com/
Creando una cuenta o iniciando sesión
Yendo a "My Apps" en tu cuenta
Creando una nueva aplicación para obtener tu clave de API

Configura tu clave de API en tu archivo de configuración de 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 ('event', 'venue' o 'attraction')

Parámetros opcionales

keyword: Término de búsqueda
startDate: Fecha de inicio en formato YYYY-MM-DD (para eventos)
endDate: Fecha de fin en formato YYYY-MM-DD (para eventos)
city: Nombre de la ciudad
stateCode: Código de estado (p. ej., 'NY')
countryCode: Código de país (p. ej., 'US')
venueId: ID de recinto específico
attractionId: ID de atracción específica
classificationName: Categoría de evento (p. ej., 'Sports', 'Music')
format: Formato de salida ('json' o 'text', por defecto 'json')

Ejemplos

Salida JSON estructurada (por defecto)

<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

<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

Clona el repositorio
Copia el archivo de entorno de ejemplo:
```
cp .env.example .env
```
Añade tu clave de API de Ticketmaster a .env
Instala las dependencias:
```
npm install
```
Compila el proyecto:
```
npm run build
```
Prueba con el inspector:
```
npm run inspector
```

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles