io.github.chrischall/setlist-mcp
NPM · SETLIST-MCP · SCANNED SEP 20
setlist.fm concert data for Claude — setlists, artists, venues, tours, and cities
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 0 of 9 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to chrischall/setlist-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability68
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 4585 tokens (~229/item across 20 items; 20 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
- Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.chrischall/setlist-mcp server?
io.github.chrischall/setlist-mcp runs locally as an npm package, launched with npx -y setlist-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · setlist-mcp
claude mcp add chrischall-setlist-mcp -- npx -y setlist-mcp
{
"mcpServers": {
"chrischall-setlist-mcp": {
"command": "npx",
"args": [
"-y",
"setlist-mcp"
]
}
}
} {
"servers": {
"chrischall-setlist-mcp": {
"command": "npx",
"args": [
"-y",
"setlist-mcp"
]
}
}
} codex mcp add chrischall-setlist-mcp -- npx -y setlist-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"chrischall-setlist-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"setlist-mcp"
],
"enabled": true
}
}
} openclaw mcp add chrischall-setlist-mcp --command npx --arg -y --arg setlist-mcp
mcp_servers:
chrischall-setlist-mcp:
command: "npx"
args: ["-y", "setlist-mcp"] {
"McpServers": {
"chrischall-setlist-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"setlist-mcp"
]
}
}
} assistant mcp add chrischall-setlist-mcp -t stdio -c npx -a -y setlist-mcp
{
"mcpServers": {
"chrischall-setlist-mcp": {
"command": "npx",
"args": [
"-y",
"setlist-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
- MCP protocol: Implements a current MCP spec version (2026-07-28). functional
- Package version: 1.0.0 → 1.1.0 functional
- 19 Sept 26 +1
- Stability: 0.87 → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: 0.87 → 1.00 ▲ functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Package version: 0.11.4 → 1.0.0 functional
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 +12
- Malware scan: unverified → pass ▲ security
- Stability: pass → 0.80 functional
- 15 Sept 26 0
- Malware scan: unverified → pass ▲ security
- Stability: 0.97 → pass security
- Package version: 0.11.3 → 0.11.4 functional
- 14 Sept 26 −14
- Stability: 0.93 → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Package version: 0.11.2 → 0.11.3 functional
- 12 Sept 26 +16
- Malware scan: unverified → pass ▲ security
- 10 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- Package version: 0.11.1 → 0.11.2 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/setlist-mcp@1.1.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | chrischall/setlist-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/chrischall/setlist-mcp/.github/workflows/release-please.yml@refs/heads/main |
| Rekor log index | 2893922699 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:04b4d47685a7b5beed32079d0f8ddef16949ba94c6cf4d468a023a837f41ff251e8f35da511d0897661e66e18667630f3c73b8fdc55dd636672410a11 |
Background: How many MCP packages publish verified provenance →
Dependencies 9 packages
| Packages resolved | 9 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
setlist_get_artist ~184
Get a setlist.fm artist by their MusicBrainz ID (mbid). Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| mbid | string | yes | Artist's MusicBrainz ID (mbid) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_artist_setlists ~212
Get an artist's setlists (most recent first) by their MusicBrainz ID (mbid). Paginated via `p`. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| mbid | string | yes | Artist's MusicBrainz ID (mbid) |
| p | integer | – | Result page number (defaults to 1) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_city ~170
Get a city by its geoId. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| geoId | string | yes | City's geoId |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_setlist ~304
Get a setlist.fm setlist by its ID, including the full song list and event details. A setlist's songs live in `sets.set[]`; each set may have an `encore` number (1 = first encore) and a `name` (e.g. an acoustic set or a full album). Each `song` may carry: `tape: true` (pre-recorded intro/outro/interlude — not actually performed), `cover` (the original artist when it is a cover), `with` (a guest performer), and `info` (a note like "acoustic" or "first time live"). Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| setlistId | string | yes | Setlist ID (e.g. 63de4613) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_setlist_version ~315
Get a specific historical version of a setlist by its version ID. Setlists are wiki-edited; each edit has a version ID returned in a setlist's `versionId` field. A setlist's songs live in `sets.set[]`; each set may have an `encore` number (1 = first encore) and a `name` (e.g. an acoustic set or a full album). Each `song` may carry: `tape: true` (pre-recorded intro/outro/interlude — not actually performed), `cover` (the original artist when it is a cover), `with` (a guest performer), and `info` (a note like "acoustic" or "first time live"). Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| versionId | string | yes | Setlist version ID |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_user ~185
Get a setlist.fm user's public profile by their userId (their setlist.fm username). Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | setlist.fm userId (username) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_user_attended ~202
Get the concerts a setlist.fm user has marked as attended. Paginated via `p`. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| p | integer | – | Result page number (defaults to 1) |
| userId | string | yes | setlist.fm userId (username) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_user_edited ~203
Get the setlists a setlist.fm user has created or edited. Paginated via `p`. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| p | integer | – | Result page number (defaults to 1) |
| userId | string | yes | setlist.fm userId (username) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_venue ~172
Get a setlist.fm venue by its ID. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| venueId | string | yes | Venue ID |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_get_venue_setlists ~201
Get setlists performed at a venue, by venue ID (most recent first). Paginated via `p`. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| p | integer | – | Result page number (defaults to 1) |
| venueId | string | yes | Venue ID |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_healthcheck Verify setlist.fm API key + connectivity ~59
Confirm the API key is configured and works by calling the setlist.fm countries endpoint. Reports {ok, authenticated, country_count} with a plain-English hint distinguishing "no key" vs "bad key" vs "API error". Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
setlist_id_from_url Extract a setlist ID from a setlist.fm URL ~167
Parse the setlist ID out of a setlist.fm setlist URL so you can paste a link instead of hunting for the ID. Returns {setlistId} (the trailing hex token before .html), ready to feed into setlist_get_setlist / setlist_mark_attended. Scoped to /setlist/ pages — artist (/setlists/) and venue (/venue/) URLs are rejected. Tolerates http/https, with/without www, trailing slash, query/fragment, and a missing .html. Pure local parsing — no network call. Errors if no ID can be parsed.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | A setlist.fm setlist URL, e.g. https://www.setlist.fm/setlist/.../...-4ba8a766.html |
No output schema declared.
No examples provided.
setlist_mark_attended ~198
Record on YOUR setlist.fm account that you attended a show — the site's "I was there" marker — by setlist ID. Authenticated via your session (needs SETLIST_SESSION_COOKIE). Idempotent: a no-op if already marked. Without confirm: true it returns a dry-run preview and makes NO change; with confirm: true it toggles attendance and verifies by re-reading your attended list. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to actually record attendance; omit for a dry-run preview. |
| setlistId | string | yes | Setlist ID (e.g. from setlist_search_setlists / resolve_concerts) |
No output schema declared.
No examples provided.
setlist_resolve_concerts ~393
Resolve many concerts to their setlists in ONE call (instead of 2+ per show). Given up to 24 `{artist, date, city?, venue?}`, returns the best-match setlist for each — `{setlistId, url, eventDate, artist, venue, city, tour, songCount, hasSongs}` — plus a `{matched, stubs, tourReferenced, unmatched, pending}` summary. For each: searches artist + date (narrowed by your city/venue), and on a miss falls back to a relevance artist lookup (by mbid) and a punctuation-normalized name so format variants still resolve. `hasSongs: false` flags an empty stub page (no songs logged on setlist.fm). When a show is a stub, if the act toured a repeating set the result also includes a `tourReference` — a populated setlist from the SAME tour on a different date (with `songs` + its own `url`), clearly labeled as a reference, NOT this exact show (set `tourFallback: false` to skip these extra lookups). Calls are paced to setlist.fm's ~2 req/sec limit; if a big batch can't finish within the time budget the rest come back `pending: true` (re-call with just those) rather than timing out. Keep batches ≤24. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| concerts | array | yes | Concerts to resolve (1–24 per call) |
| tourFallback | boolean | – | For empty stubs, also fetch a same-tour reference setlist (default true). Set false to skip the extra lookups. |
No output schema declared.
No examples provided.
setlist_search_artists ~260
Search setlist.fm for artists by name or MusicBrainz ID. Returns matching artists with their MusicBrainz ID (mbid) — use that mbid with setlist_get_artist or setlist_get_artist_setlists. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| artistMbid | string | – | Artist's MusicBrainz ID (mbid) |
| artistName | string | – | Artist name to search for |
| p | integer | – | Result page number (defaults to 1) |
| sort | string | – | Sort order (sortName = default, or relevance) |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_search_cities ~255
Search setlist.fm for cities by name and/or location. Returns cities with their geoId — use it as cityId in setlist_search_setlists / setlist_search_venues, or with setlist_get_city. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | City's country |
| name | string | – | City name |
| p | integer | – | Result page number (defaults to 1) |
| state | string | – | State the city lies in |
| stateCode | string | – | State code the city lies in |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_search_countries ~180
List all countries supported by setlist.fm, with their ISO country codes. Use a code as countryCode in setlist_search_setlists. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_search_setlists ~478
Search setlist.fm for concert setlists. Filter by any combination of artist, venue, city, country, tour, date, or year (provide at least one). Combine filters to disambiguate — artistName + date can span multiple cities, so add cityName/cityId or venueName/venueId to pin the exact show. Omit the artist and pass venueName/venueId + date to list EVERY performer at a venue or festival that day. Every result includes songCount, setCount, and hasSongs, so you can skip empty 'stub' setlists (hasSongs: false) without a second fetch. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| artistMbid | string | – | Artist's MusicBrainz ID (mbid) |
| artistName | string | – | Artist name |
| cityId | string | – | City's geoId |
| cityName | string | – | City name |
| countryCode | string | – | Country code (ISO 3166-1 alpha-2) |
| date | string | – | Event date, ISO yyyy-MM-dd (e.g. 2025-08-28) |
| lastUpdated | string | – | Only setlists updated on/after this UTC time, ISO yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss |
| p | integer | – | Result page number (defaults to 1) |
| state | string | – | State name |
| stateCode | string | – | State code |
| tourName | string | – | Tour name |
| venueId | string | – | Venue ID |
| venueName | string | – | Venue name |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
| year | integer | – | Event year |
No output schema declared.
No examples provided.
setlist_search_venues ~266
Search setlist.fm for venues by name and/or location. Returns matching venues with their venue ID — use it with setlist_get_venue or setlist_get_venue_setlists. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| cityId | string | – | City's geoId |
| cityName | string | – | City the venue is in |
| country | string | – | Venue's country |
| name | string | – | Venue name |
| p | integer | – | Result page number (defaults to 1) |
| state | string | – | State name |
| stateCode | string | – | State code |
| view | string | – | Response shape: "compact" (default) drops fields the response already carries elsewhere; "full" returns every field this server understands. compact strips image/avatar URLs from the response; "full"… |
No output schema declared.
No examples provided.
setlist_unmark_attended ~181
Remove a show from YOUR attended list on setlist.fm, by setlist ID (reverses setlist_mark_attended). Authenticated via your session. Idempotent: a no-op if not currently attended. Without confirm: true it returns a dry-run preview and makes NO change; with confirm: true it removes the attendance and verifies by re-reading. Results include a setlist.fm `url`; when you present this data, cite it as a clickable source link to setlist.fm (their API terms require followable attribution — no nofollow). If a result has no `url`, link to https://www.setlist.fm instead.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Must be true to actually remove attendance; omit for a dry-run preview. |
| setlistId | string | yes | Setlist ID to remove from your attended shows |
No output schema declared.
No examples provided.
What is the io.github.chrischall/setlist-mcp server?
io.github.chrischall/setlist-mcp is listed in the public MCP registry as io.github.chrischall/setlist-mcp. setlist.fm concert data for Claude, setlists, artists, venues, tours, and cities. This page covers its npm package (setlist-mcp).
Is the io.github.chrischall/setlist-mcp server safe to use?
io.github.chrischall/setlist-mcp scores 93 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.chrischall/setlist-mcp server expose?
io.github.chrischall/setlist-mcp exposes 20 tools: setlist_search_artists, setlist_get_artist, setlist_get_artist_setlists, setlist_search_setlists, setlist_get_setlist, and 15 more. Their descriptions and schemas cost roughly 4,585 tokens of context every time the server is loaded.
Is the io.github.chrischall/setlist-mcp server still maintained?
io.github.chrischall/setlist-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.chrischall/setlist-mcp server under?
io.github.chrischall/setlist-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.