convez.ai
MCP ServerIntegração & APIsIntermediário
chrischall

Setlist MCP

chrischall/setlist-mcp

Busque setlists de shows, artistas e venues do setlist.fm via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra o setlist.fm ao Claude, permitindo buscar setlists de shows, artistas, venues e turnês via linguagem natural. Oferece 20 ferramentas para consulta de dados de concertos e ações autenticadas de presença.

Instalação

$npx convez-ai chrischall/setlist-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 dias
Versão
v1.2.0
Issues abertas
1
Contribuidores
2

Casos de uso

  • Pesquisar histórico de setlists de artistas favoritos
  • Encontrar informações sobre venues e cidades para planejamento de viagens
  • Marcar presença em shows que você assistiu
  • Explorar padrões de repertório de bandas em turnês

Veredito

MCP bem estruturado e mantido que expõe a API do setlist.fm de forma acessível ao Claude. Requer chave de API gratuita e respeita termos de atribuição e uso não-comercial da plataforma — ideal para fãs de música que querem contextualizar dados de concertos em conversas.

README

A tradução para o português deste README ainda está na fila.

setlist-mcp

CI npm

MCP server for setlist.fm — search concert setlists, artists, venues, tours, and cities from Claude via natural language. Mostly read-only (the setlist.fm REST API exposes no write endpoints), plus authenticated "I was there" attendance actions via your logged-in session.

This project was developed and is maintained by AI (Claude). Use at your own discretion.

What it does

Exposes 20 tools — 18 read-only over the setlist.fm REST API, plus 2 authenticated "I was there" attendance actions:

AreaTools
Artistssetlist_search_artists, setlist_get_artist, setlist_get_artist_setlists
Setlistssetlist_search_setlists, setlist_get_setlist, setlist_get_setlist_version
Venuessetlist_search_venues, setlist_get_venue, setlist_get_venue_setlists
Cities & countriessetlist_search_cities, setlist_get_city, setlist_search_countries
Userssetlist_get_user, setlist_get_user_attended, setlist_get_user_edited
Resolvesetlist_resolve_concerts
Attendance (authenticated writes)setlist_mark_attended, setlist_unmark_attended
Utilitysetlist_healthcheck, setlist_id_from_url

Setup

Get a free API key (non-commercial use) at setlist.fm/settings/api, then add the server to your .mcp.json:

{
  "mcpServers": {
    "setlist": {
      "command": "npx",
      "args": ["-y", "setlist-mcp"],
      "env": {
        "SETLIST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Optional: SETLIST_ACCEPT_LANGUAGE (one of en, es, fr, de, pt, tr, it, pl) localizes city/country names.

See SKILL.md for from-source setup, the full tool reference, and example flows.

Attribution & terms

Use is governed by the setlist.fm API terms. In short:

  • Attribute setlist.fm. Every result carries a url; surface it as a followable source link (no nofollow) wherever the data is shown. The tool descriptions instruct the model to do this, and results pass the url through verbatim.
  • Non-commercial only under a free key — commercial use requires setlist.fm's permission.
  • No persistent caching — this server makes a live API call per tool invocation and keeps no datastore. Please don't add one.
  • Keep your API key private — it lives in SETLIST_API_KEY (.env is gitignored) and never appears in tool output.

Development

npm install
npm run build   # tsc + esbuild bundle → dist/
npm test        # vitest

For local runs, put SETLIST_API_KEY=<key> in a .env file (gitignored) next to the project root.

See CLAUDE.md for architecture, conventions, and gotchas.

License

MIT

Ver o original no GitHub

Bom para

Relacionados