How do I install Setlist?

Setlist is a local plugin. Install it using npm package: setlist-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Setlist safe to use?

Yes. Setlist passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Setlist need?

Setlist requires the following credentials or environment variables: SETLIST_API_KEY, SETLIST_ACCEPT_LANGUAGE, SETLIST_SESSION_COOKIE, SETLIST_DISABLE_FETCHPROXY, FETCHPROXY_WS_PORT, FETCHPROXY_WS_HOST, FETCHPROXY_IDENTITY_DIR. You can find setup instructions on the server detail page.

What AI apps work with Setlist?

Setlist uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Setlist MCP Server

by Chris Hall

Developer ToolsLow Risk10.0Local

Free

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (95/96 approved); 6 highly-trusted packages.

6 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your setlist.fm API key (apply at setlist.fm/settings/api). Required for the data (read) tools; the attendance tools and setlist_id_from_url work without it.Required

Environment variable: SETLIST_API_KEY

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

Environment variable: SETLIST_ACCEPT_LANGUAGE

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

Environment variable: SETLIST_SESSION_COOKIE

Set to 1 to turn the browser (fetchproxy) fallback off for the attendance tools (1/true/yes/on).Optional

Environment variable: SETLIST_DISABLE_FETCHPROXY

Localhost port of the fetchproxy concentrator the ContextMint Bridge extension connects to (default 37149). Every MCP on one machine shares it, so move it for all of them or not at all.Optional

Environment variable: FETCHPROXY_WS_PORT

Bind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace.Optional

Environment variable: FETCHPROXY_WS_HOST

Absolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).Optional

Environment variable: FETCHPROXY_IDENTITY_DIR

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-chrischall-setlist-mcp": {
      "env": {
        "SETLIST_API_KEY": "your-setlist-api-key-here",
        "SETLIST_SESSION_COOKIE": "your-setlist-session-cookie-here",
        "SETLIST_ACCEPT_LANGUAGE": "your-setlist-accept-language-here"
      },
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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:

{
  "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.

The attendance tools (setlist_mark_attended / setlist_unmark_attended) need your logged-in www.setlist.fm session. Either set SETLIST_SESSION_COOKIE to the Cookie header of a logged-in request, or install ContextMint Bridge (Chrome: load the chrome zip unpacked; Safari isn't available yet — it will ship inside the ContextMint app, which has no public download — so use Chrome for now) and stay signed in to www.setlist.fm — the server lifts the session cookie from your browser on first use. Set SETLIST_DISABLE_FETCHPROXY=1 to turn the browser fallback off.

ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer — fetchproxy's own README points to it. Its source is public at nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).

See skills/setlist/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        # tsc typecheck + 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

Reviews

No reviews yet

Be the first to review this server!

4.7

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

Stars

161

Installs