io.github.chrischall/setlist-mcp

Official

by chrischall · TypeScript

setlist.fm concert data for Claude — setlists, artists, venues, tours, and cities

Access concert setlists, artist information, venues, and tour data.

setlist-mcp

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:

Area	Tools
Artists	`setlist_search_artists`, `setlist_get_artist`, `setlist_get_artist_setlists`
Setlists	`setlist_search_setlists`, `setlist_get_setlist`, `setlist_get_setlist_version`
Venues	`setlist_search_venues`, `setlist_get_venue`, `setlist_get_venue_setlists`
Cities & countries	`setlist_search_cities`, `setlist_get_city`, `setlist_search_countries`
Users	`setlist_get_user`, `setlist_get_user_attended`, `setlist_get_user_edited`
Resolve	`setlist_resolve_concerts`
Attendance (authenticated writes)	`setlist_mark_attended`, `setlist_unmark_attended`
Utility	`setlist_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:

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

bash

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

Install

Configuration

Environment variables

SETLIST_API_KEYrequiredsecret

Your setlist.fm API key (apply at setlist.fm/settings/api)

SETLIST_ACCEPT_LANGUAGE

Optional language for city/country names (en, es, fr, de, pt, tr, it, pl)

SETLIST_SESSION_COOKIEsecret

Optional. Logged-in www.setlist.fm Cookie header — enables the attendance write tools.

claude_desktop_config.json

{
  "mcpServers": {
    "setlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp@0.7.3"
      ],
      "env": {
        "SETLIST_API_KEY": "<YOUR_SETLIST_API_KEY>",
        "SETLIST_ACCEPT_LANGUAGE": "<YOUR_SETLIST_ACCEPT_LANGUAGE>",
        "SETLIST_SESSION_COOKIE": "<YOUR_SETLIST_SESSION_COOKIE>"
      }
    }
  }
}