setlist-mcp
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-mcpWhat 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.
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 |
|
Setlists |
|
Venues |
|
Cities & countries |
|
Users |
|
Resolve |
|
Attendance (authenticated writes) |
|
Utility |
|
Related MCP server: Spotify MCP Server
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 (nonofollow) wherever the data is shown. The tool descriptions instruct the model to do this, and results pass theurlthrough 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(.envis gitignored) and never appears in tool output.
Development
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.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
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