Ticketmaster

Descubra eventos, locais e atrações usando a API Discovery do Ticketmaster.

Documentação

Servidor MCP para Ticketmaster

Um servidor Model Context Protocol que fornece ferramentas para descobrir eventos, locais e atrações por meio da API Discovery do Ticketmaster.

Recursos

Pesquise eventos, locais e atrações com filtros flexíveis:
- Pesquisa por palavra-chave
- Intervalo de datas para eventos
- Localização (cidade, estado, país)
- Pesquisas específicas por local
- Pesquisas específicas por atração
- Classificações/categorias de eventos
Formatos de saída:
- Dados JSON estruturados para uso programático
- Texto legível para consumo direto
Dados abrangentes, incluindo:
- Nomes e IDs
- Datas e horários (para eventos)
- Faixas de preço (para eventos)
- URLs
- Imagens
- Localizações e endereços (para locais)
- Classificações (para atrações)

Instalação

Instalando via Smithery

Para instalar o mcp-server-ticketmaster para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

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

Configuração

O servidor requer uma chave de API do Ticketmaster. Você pode obter uma:

Acessando https://developer.ticketmaster.com/
Criando uma conta ou fazendo login
Indo em "Meus Aplicativos" na sua conta
Criando um novo aplicativo para obter sua chave de API

Defina sua chave de API no arquivo de configurações do MCP:

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

Uso

O servidor fornece uma ferramenta chamada search_ticketmaster que aceita:

Parâmetros Obrigatórios

type: Tipo de pesquisa ('event', 'venue' ou 'attraction')

Parâmetros Opcionais

keyword: Termo de pesquisa
startDate: Data de início no formato AAAA-MM-DD (para eventos)
endDate: Data de término no formato AAAA-MM-DD (para eventos)
city: Nome da cidade
stateCode: Código do estado (ex.: 'NY')
countryCode: Código do país (ex.: 'US')
venueId: ID específico do local
attractionId: ID específico da atração
classificationName: Categoria do evento (ex.: 'Esportes', 'Música')
format: Formato de saída ('json' ou 'text', padrão é 'json')

Exemplos

Saída JSON Estruturada (Padrão)

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

Saída de Texto Legível

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

Desenvolvimento

Clone o repositório
Copie o arquivo de ambiente de exemplo:
```
cp .env.example .env
```
Adicione sua chave de API do Ticketmaster ao .env
Instale as dependências:
```
npm install
```
Compile o projeto:
```
npm run build
```
Teste com o inspetor:
```
npm run inspector
```

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes