setlist-mcp provides tools to search and explore concert setlists, artists, venues, cities, and users on setlist.fm, plus authenticated attendance actions.
Artists — search by name or MusicBrainz ID, retrieve artist profiles, and list an artist's setlists.
Setlists — search by any combination of artist, venue, city, country, tour, date, or year; fetch full setlist details by ID (songs, encores, covers, guest performers); retrieve historical versions.
Venues — search by name/location, get venue details, and list all setlists performed at a venue.
Cities & Countries — search cities by name/location, get city details by geoId, and list all countries supported by setlist.fm.
Users — get a user's public profile, view concerts they've attended, and see setlists they've created or edited.
Bulk concert resolution — resolve up to 24 concerts (artist + date + optional city/venue) to their setlists in a single call.
Attendance tracking (authenticated) — mark or unmark concerts as attended on your setlist.fm account, with a dry-run preview mode before committing.
Utility — extract a setlist ID from a setlist.fm URL, and run a healthcheck to verify your API key and connectivity.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@setlist-mcp What was the setlist for Nirvana's last show?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Exposes 20 tools — 18 read-only over the setlist.fm REST API, plus 2 authenticated "I was there" attendance actions:
Area | Tools |
Artists |
|
Setlists |
|
Venues |
|
Cities & countries |
|
Users |
|
Resolve |
|
Attendance (authenticated writes) |
|
Utility |
|
Related MCP server: MusicBrainz MCP Server
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 skills/setlist/SKILL.md for from-source setup, the full tool reference, and example flows.
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.
npm install
npm run build # tsc + esbuild bundle → dist/
npm test # vitestFor 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.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
setlist.fm: concert setlists by artist/venue/date. Free key required.
Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.
Live-concert discovery: 44,000+ upcoming concerts worldwide by city, artist, genre or festival.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrischall/setlist-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server