Skip to content
MCP server

Setlist MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.0
Listing updated
4 days ago

About Setlist MCP

Setlist MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add setlist-mcp --env SETLIST_API_KEY='<SETLIST_API_KEY>' --env SETLIST_SESSION_COOKIE='<SETLIST_SESSION_COOKIE>' -- npx -y setlist-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "setlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "env": {
        "SETLIST_API_KEY": "<SETLIST_API_KEY>",
        "SETLIST_SESSION_COOKIE": "<SETLIST_SESSION_COOKIE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "setlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "env": {
        "SETLIST_API_KEY": "<SETLIST_API_KEY>",
        "SETLIST_SESSION_COOKIE": "<SETLIST_SESSION_COOKIE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "setlist-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "env": {
        "SETLIST_API_KEY": "<SETLIST_API_KEY>",
        "SETLIST_SESSION_COOKIE": "<SETLIST_SESSION_COOKIE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "setlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "env": {
        "SETLIST_API_KEY": "<SETLIST_API_KEY>",
        "SETLIST_SESSION_COOKIE": "<SETLIST_SESSION_COOKIE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "setlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "setlist-mcp"
      ],
      "env": {
        "SETLIST_API_KEY": "<SETLIST_API_KEY>",
        "SETLIST_SESSION_COOKIE": "<SETLIST_SESSION_COOKIE>"
      }
    }
  }
}

Configuration

  • SETLIST_API_KEYYour 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.
  • SETLIST_ACCEPT_LANGUAGEOptional language for city/country names (en, es, fr, de, pt, tr, it, pl)
  • SETLIST_SESSION_COOKIEOptional. Logged-in www.setlist.fm Cookie header — enables the attendance write tools.
  • SETLIST_DISABLE_FETCHPROXYSet to 1 to turn the browser (fetchproxy) fallback off for the attendance tools (1/true/yes/on).
  • FETCHPROXY_WS_PORTLocalhost 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.
  • FETCHPROXY_WS_HOSTBind 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.
  • FETCHPROXY_IDENTITY_DIRAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Pricing

Open source

Setlist MCP FAQ

Is Setlist MCP free?

Yes. Setlist MCP is open source, so you can use and self-host it for free.

How do I add Setlist MCP to Claude Code?

Run this command in your terminal: claude mcp add setlist-mcp --env SETLIST_API_KEY='<SETLIST_API_KEY>' --env SETLIST_SESSION_COOKIE='<SETLIST_SESSION_COOKIE>' -- npx -y setlist-mcp