setlist
Look up concert setlists and live-music history via setlist.fm. Use when the user asks what songs an artist played at a show, their tour setlists, what was performed at a venue or on a date, or wants to find concerts by artist, venue, city, or year. Triggers on phrases like "what did Radiohead play at...", "Phish setlist for...", "shows at Red Rocks", "what songs were played on this tour", or any request about concert setlists, gigs, tours, or live performances. Requires setlist-mcp installed and the setlist server registered (see Setup below).
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
1.1.8
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.7K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.1.8release · observed Oct 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:setlist- Install using `clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:setlist` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/chrischall/setlist before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-setlist/snapshot"
Documentation
CLAWHUB
127,893 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: setlist
description: Look up concert setlists and live-music history via setlist.fm. Use when the user asks what songs an artist played at a show, their tour setlists, what was performed at a venue or on a date, or wants to find concerts by artist, venue, city, or year. Triggers on phrases like "what did Radiohead play at...", "Phish setlist for...", "shows at Red Rocks", "what songs were played on this tour", or any request about concert setlists, gigs, tours, or live performances. Requires setlist-mcp installed and the setlist server registered (see Setup below).
---
# setlist-mcp
MCP server for setlist.fm — search concert setlists, artists, venues, and tours via natural language. Read-only (setlist.fm has no write API).
- **npm:** [npmjs.com/package/setlist-mcp](https://www.npmjs.com/package/setlist-mcp)
- **Source:** [github.com/chrischall/setlist-mcp](https://github.com/chrischall/setlist-mcp)
## Setup
### Option A — npx (recommended)
Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
```json
{
"mcpServers": {
"setlist": {
"command": "npx",
"args": ["-y", "setlist-mcp"],
"env": {
"SETLIST_API_KEY": "your-api-key-here"
}
}
}
}
```
### Option B — from source
```bash
git clone https://github.com/chrischall/setlist-mcp
cd setlist-mcp
npm install && npm run build
```
Then add to `.mcp.json`:
```json
{
"mcpServers": {
"setlist": {
"command": "node",
"args": ["/path/to/setlist-mcp/dist/index.js"],
"env": {
"SETLIST_API_KEY": "your-api-key-here"
}
}
}
}
```
Or use a `.env` file in the project directory with `SETLIST_API_KEY=<value>`.
### Getting your API key
Apply for a free API key (non-commercial use) at [setlist.fm/settings/api](https://www.setlist.fm/settings/api) — you'll need a setlist.fm account. The key is sent as the `x-api-key` header on every request.
Optional: set `SETLIST_ACCEPT_LANGUAGE` (one of `en, es, fr, de, pt, tr, it, pl`) to localize city/country names.
## Tools
All tools are prefixed `setlist_`. Everything below is read-only; the two
attendance tools (`setlist_mark_attended` / `setlist_unmark_attended`) write to
your setlist.fm account. Each undoes the other, so neither asks for a
confirmation step.
### Artists
- **`setlist_search_artists`** — find artists by `artistName` or `artistMbid`; returns each artist's MusicBrainz ID (`mbid`).
- **`setlist_get_artist`** — get an artist by `mbid`.
- **`setlist_get_artist_setlists`** — an artist's setlists (most recent first), by `mbid`, paginated via `p`.
### Setlists
- **`setlist_search_setlists`** — search by any mix of artist, venue, city, country, tour, `date` (ISO yyyy-MM-dd), or `year`.
- **`setlist_get_setlist`** — a setlist (with full song list) by `setlistId`.
- **`setlist_get_setlist_version`** — a specific historical version by `versionId`.
### Batch
- **`setlist_resolve_concerts`** — resolve up to **24** `{artist, date, city?, venue?}` to their best-m_meta.json
{
"ownerId": "kn700jq4sjtf2anb0rk3ft4p7n856872",
"slug": "setlist",
"version": "1.1.8",
"publishedAt": 1791588531096
}skill-card.md
## Description: Helps agents look up concert setlists and live-music history through setlist.fm. This skill is ready for commercial/non-commercial use. ## Publisher: [chrischall](https://clawhub.ai/user/chrischall) ### License/Terms of Use: MIT-0 ## Use Case: Music fans and researchers use this skill to find songs performed at concerts and explore shows by artist, venue, city, date, or tour. It also offers tools to mark or unmark concerts as attended on a user's account. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Despite read-only wording, attendance tools can change the user's setlist.fm account without a built-in confirmation step. Mitigation: Require explicit user approval before marking or unmarking any concert as attended. Risk: The integration requires access to a user's setlist.fm API key. Mitigation: Provide the key only to a trusted server and do not expose or share it in responses. Risk: A free setlist.fm API key is limited to non-commercial use, even though this release has a commercial usage posture. Mitigation: Obtain setlist.fm permission before commercial API use and include source links when presenting results. ## Reference(s): - [setlist-mcp package](https://www.npmjs.com/package/setlist-mcp) - [setlist.fm API key setup](https://www.setlist.fm/settings/api) ## Skill Output: **Output Type(s):** [Text, Markdown] **Output Format:** [Markdown with links to setlist.fm results] **Output Parameters:** [1D] **Other Properties Related to Output:** [Answers may include song lists, show details, and links to the source results.] ## Skill Version(s): 1.1.8 (source: server-resolved release) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/chrischall/skills/setlist",
"sourceUrl": "https://clawhub.ai/chrischall/skills/setlist",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:00:25.196Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-setlist/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-setlist/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T05:00:25.196Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/chrischall/setlist",
"sourceUrl": "https://clawhub.ai/chrischall/setlist",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:00:25.196Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.1.8",
"href": "https://clawhub.ai/chrischall/setlist",
"sourceUrl": "https://clawhub.ai/chrischall/setlist",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-09T23:28:51.096Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-setlist/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-setlist/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.1.8",
"description": "- Removed the skill-card.md file. - No user-facing functionality or API changes; only documentation/assets adjustment.",
"href": "https://clawhub.ai/chrischall/setlist",
"sourceUrl": "https://clawhub.ai/chrischall/setlist",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-09T23:28:51.096Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
