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.

What credentials does Setlist need?

Setlist requires the following credentials or environment variables: SETLIST_API_KEY, SETLIST_ACCEPT_LANGUAGE. 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.0LocalNew

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 (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (26/27 approved).

12 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.

file_system

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

env_vars

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

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your setlist.fm API key (apply at setlist.fm/settings/api)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

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_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. Read-only (setlist.fm exposes no write API).

This project was developed and is maintained by AI (Claude). Use at your own discretion.

What it does

Exposes 16 read-only tools over the setlist.fm REST API:

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`
Utility	`setlist_healthcheck`

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 (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        # 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!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Setlist MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install

Documentation

setlist-mcp

What it does

Setup

Attribution & terms

Development

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent