setlist-mcp 0.3.0 → 0.4.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for setlist.fm — concert setlists, artists, venues, and tours via the setlist.fm API",
-    "version": "0.3.0"
+    "version": "0.4.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "setlist.fm",
       "source": "./",
       "description": "MCP server for setlist.fm — search concert setlists, artists, venues, and tours via natural language",
-      "version": "0.3.0",
+      "version": "0.4.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "setlist-mcp",
   "displayName": "setlist.fm",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "MCP server for setlist.fm — search concert setlists, artists, venues, and tours via the setlist.fm API",
   "author": {
     "name": "Chris Hall",

package/SKILL.md

@@ -72,7 +72,7 @@ All tools are read-only and prefixed `setlist_`.
 - **`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` (dd-MM-yyyy), or `year`.
+- **`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`.
 
@@ -98,7 +98,7 @@ All tools are read-only and prefixed `setlist_`.
 
 - **"What did Radiohead play at their last show?"** → `setlist_search_artists` (Radiohead → mbid) → `setlist_get_artist_setlists` (latest) → `setlist_get_setlist` for the song list.
 - **"Setlists at Red Rocks in 2023"** → `setlist_search_venues` (Red Rocks → venueId) → `setlist_search_setlists` with `venueId` + `year: 2023`.
-- **"Phish on 2023-08-07"** → `setlist_search_setlists` with `artistName: "Phish"`, `date: "07-08-2023"` (note the dd-MM-yyyy format).
+- **"Phish on 2023-08-07"** → `setlist_search_setlists` with `artistName: "Phish"`, `date: "2023-08-07"`.
 
 ## Attribution & API terms
 
@@ -117,6 +117,6 @@ setlist.fm's [API terms](https://www.setlist.fm/help/api-terms) bind anyone usin
 ## Notes
 
 - IDs chain: `search_*` tools return the `mbid` / `setlistId` / `venueId` / `geoId` you feed into the `get_*` tools.
-- `date` filters use **dd-MM-yyyy** (e.g. `07-08-2023` = 7 August 2023).
+- **All dates are ISO `yyyy-MM-dd`** — both the `date`/`lastUpdated` inputs and every `eventDate` in the output. (The server translates to/from setlist.fm's native `dd-MM-yyyy` internally.)
 - Results are paginated; pass `p` (1-based) to page through large result sets.
 - setlist.fm rate-limits the standard tier (~2 req/sec); a 429 is retried once.

package/dist/bundle.js

@@ -31001,6 +31001,22 @@ function textResult(data) {
     content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
   };
 }
+function deepMapStringField(value, field, map2) {
+  if (Array.isArray(value)) {
+    for (const item of value)
+      deepMapStringField(item, field, map2);
+  } else if (value !== null && typeof value === "object") {
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+      const v = obj[key];
+      if (key === field && typeof v === "string")
+        obj[key] = map2(v);
+      else
+        deepMapStringField(v, field, map2);
+    }
+  }
+  return value;
+}
 
 // node_modules/@chrischall/mcp-utils/dist/errors/index.js
 var DEFAULT_ERROR_MESSAGE_MAX = 500;
@@ -31071,6 +31087,15 @@ var RateLimitedError = class extends Error {
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
+var RequestTimeoutError = class extends Error {
+  timeoutMs;
+  constructor(service, timeoutMs) {
+    super(`Request to ${service} timed out after ${timeoutMs}ms.`);
+    this.name = "RequestTimeoutError";
+    this.timeoutMs = timeoutMs;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
 function hostOf(baseUrl) {
   try {
     return new URL(baseUrl).host;
@@ -31086,6 +31111,18 @@ function createApiClient(opts) {
   const sleep = opts.sleep ?? defaultSleep;
   const unauthorized = () => opts.onUnauthorized ? opts.onUnauthorized() : new UnauthorizedError(service);
   const rateLimited = () => opts.onRateLimited ? opts.onRateLimited() : new RateLimitedError(service);
+  const timeoutMs = opts.timeout;
+  function withTimeout(run) {
+    if (timeoutMs == null || timeoutMs <= 0)
+      return run(void 0);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    return run(controller.signal).catch((err) => {
+      if (err instanceof Error && err.name === "AbortError")
+        throw new RequestTimeoutError(service, timeoutMs);
+      throw err;
+    }).finally(() => clearTimeout(timer));
+  }
   async function send(method, path, opt) {
     const isMultipart = opt.formData !== void 0;
     const hasJsonBody = !isMultipart && opt.body !== void 0;
@@ -31093,7 +31130,7 @@ function createApiClient(opts) {
     const query = opt.query ? buildQueryString(opt.query) : "";
     const url2 = `${base}${path}${query}`;
     const bodyInit = reqBody !== void 0 ? { body: reqBody } : {};
-    const fetchWith = (token) => doFetch(url2, {
+    const fetchWith = (token, signal) => doFetch(url2, {
       method,
       headers: {
         Accept: "application/json",
@@ -31102,9 +31139,10 @@ function createApiClient(opts) {
         ...token ? { Authorization: `Bearer ${token}` } : {},
         ...opt.headers
       },
+      ...signal ? { signal } : {},
       ...bodyInit
     });
-    const once = opts.tokenManager ? () => opts.tokenManager.withAuth(fetchWith) : async () => fetchWith(await opts.getToken?.() || void 0);
+    const once = () => withTimeout((signal) => opts.tokenManager ? opts.tokenManager.withAuth((token) => fetchWith(token, signal)) : (async () => fetchWith(await opts.getToken?.() || void 0, signal))());
     let attempt = 0;
     for (; ; ) {
       const res = await once();
@@ -31171,6 +31209,29 @@ function formatApiError(status, method, path, errorText, opts = {}) {
   return safe.length > 0 ? `${head}: ${safe}` : head;
 }
 
+// node_modules/@chrischall/mcp-utils/dist/dates/index.js
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var DMY_DATE = /^(\d{2})-(\d{2})-(\d{4})$/;
+var ISO_DATETIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?$/;
+function isoToDmy(date5) {
+  const m = ISO_DATE.exec(date5.trim());
+  return m ? `${m[3]}-${m[2]}-${m[1]}` : date5.trim();
+}
+function dmyToIso(date5) {
+  const m = DMY_DATE.exec(date5.trim());
+  return m ? `${m[3]}-${m[2]}-${m[1]}` : date5.trim();
+}
+function isoToCompactTimestamp(value) {
+  const v = value.trim();
+  const d = ISO_DATE.exec(v);
+  if (d)
+    return `${d[1]}${d[2]}${d[3]}000000`;
+  const dt = ISO_DATETIME.exec(v);
+  if (dt)
+    return `${dt[1]}${dt[2]}${dt[3]}${dt[4]}${dt[5]}${dt[6] ?? "00"}`;
+  return v;
+}
+
 // node_modules/@chrischall/mcp-utils/dist/zod/index.js
 var PositiveInt = external_exports.number().int().positive();
 var NonNegInt = external_exports.number().int().nonnegative();
@@ -31197,7 +31258,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.0";
 
 // src/client.ts
 import { dirname, join } from "path";
@@ -31206,6 +31267,7 @@ var __dirname = dirname(fileURLToPath(import.meta.url));
 await loadDotenvSafely({ path: join(__dirname, "..", ".env"), override: false });
 var BASE_URL = "https://api.setlist.fm/rest";
 var SERVICE_NAME = "setlist.fm";
+var REQUEST_TIMEOUT_MS = 15e3;
 var SetlistClient = class {
   apiKey;
   configError;
@@ -31229,7 +31291,8 @@ var SetlistClient = class {
       baseUrl: BASE_URL,
       serviceName: SERVICE_NAME,
       retry: { count: 1, delayMs: 2e3 },
-      baseHeaders: lang ? { "Accept-Language": lang } : void 0
+      baseHeaders: lang ? { "Accept-Language": lang } : void 0,
+      timeout: REQUEST_TIMEOUT_MS
     });
   }
   requireKey() {
@@ -31243,11 +31306,12 @@ var SetlistClient = class {
    */
   async request(method, path, opts = {}) {
     const apiKey = this.requireKey();
-    return this.api.fetchJson(method, path, {
+    const data = await this.api.fetchJson(method, path, {
       headers: { "x-api-key": apiKey },
       ...opts.query !== void 0 ? { query: opts.query } : {},
       ...opts.body !== void 0 ? { body: opts.body } : {}
     });
+    return deepMapStringField(data, "eventDate", dmyToIso);
   }
 };
 var client = new SetlistClient();
@@ -31332,14 +31396,17 @@ function registerSetlistTools(server) {
         stateCode: external_exports.string().optional().describe("State code"),
         countryCode: external_exports.string().optional().describe("Country code (ISO 3166-1 alpha-2)"),
         tourName: external_exports.string().optional().describe("Tour name"),
-        date: external_exports.string().optional().describe("Event date in dd-MM-yyyy format (e.g. 07-08-2023)"),
+        date: external_exports.string().optional().describe("Event date, ISO yyyy-MM-dd (e.g. 2025-08-28)"),
         year: external_exports.number().int().optional().describe("Event year"),
-        lastUpdated: external_exports.string().optional().describe("Only setlists updated after this UTC time (format yyyyMMddHHmmss)"),
+        lastUpdated: external_exports.string().optional().describe("Only setlists updated on/after this UTC time, ISO yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss"),
         p: page2
       }
     },
     async (args) => {
-      const data = await client.request("GET", "/1.0/search/setlists", { query: args });
+      const query = { ...args };
+      if (args.date) query.date = isoToDmy(args.date);
+      if (args.lastUpdated) query.lastUpdated = isoToCompactTimestamp(args.lastUpdated);
+      const data = await client.request("GET", "/1.0/search/setlists", { query });
       return textResult(data);
     }
   );

package/dist/client.js

@@ -1,6 +1,6 @@
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
-import { loadDotenvSafely, readEnvVar, createApiClient, } from '@chrischall/mcp-utils';
+import { loadDotenvSafely, readEnvVar, createApiClient, deepMapStringField, dmyToIso, } from '@chrischall/mcp-utils';
 // Load .env for local dev; silently skip if dotenv is unavailable (e.g. the
 // mcpb bundle). `loadDotenvSafely` swallows a missing dotenv module and never
 // lets .env override a host-provided value.
@@ -8,6 +8,10 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 await loadDotenvSafely({ path: join(__dirname, '..', '.env'), override: false });
 const BASE_URL = 'https://api.setlist.fm/rest';
 const SERVICE_NAME = 'setlist.fm';
+// Bound every request so a slow/hung upstream fails fast (createApiClient throws
+// RequestTimeoutError) instead of hanging the tool call. setlist.fm normally
+// answers in well under a second.
+const REQUEST_TIMEOUT_MS = 15_000;
 export class SetlistClient {
     apiKey;
     configError;
@@ -37,6 +41,7 @@ export class SetlistClient {
             serviceName: SERVICE_NAME,
             retry: { count: 1, delayMs: 2000 },
             baseHeaders: lang ? { 'Accept-Language': lang } : undefined,
+            timeout: REQUEST_TIMEOUT_MS,
         });
     }
     requireKey() {
@@ -51,11 +56,13 @@ export class SetlistClient {
      */
     async request(method, path, opts = {}) {
         const apiKey = this.requireKey();
-        return this.api.fetchJson(method, path, {
+        const data = await this.api.fetchJson(method, path, {
             headers: { 'x-api-key': apiKey },
             ...(opts.query !== undefined ? { query: opts.query } : {}),
             ...(opts.body !== undefined ? { body: opts.body } : {}),
         });
+        // Surface every date as ISO yyyy-MM-dd (the API returns eventDate as dd-MM-yyyy).
+        return deepMapStringField(data, 'eventDate', dmyToIso);
     }
 }
 /**

package/dist/tools/setlists.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textResult } from '@chrischall/mcp-utils';
+import { textResult, isoToDmy, isoToCompactTimestamp } from '@chrischall/mcp-utils';
 import { client } from '../client.js';
 import { ATTRIBUTION_NOTE } from '../attribution.js';
 // How to read a setlist's song data (per setlist.fm's guidelines), so the model
@@ -27,16 +27,24 @@ export function registerSetlistTools(server) {
             stateCode: z.string().optional().describe('State code'),
             countryCode: z.string().optional().describe('Country code (ISO 3166-1 alpha-2)'),
             tourName: z.string().optional().describe('Tour name'),
-            date: z.string().optional().describe('Event date in dd-MM-yyyy format (e.g. 07-08-2023)'),
+            date: z
+                .string()
+                .optional()
+                .describe('Event date, ISO yyyy-MM-dd (e.g. 2025-08-28)'),
             year: z.number().int().optional().describe('Event year'),
             lastUpdated: z
                 .string()
                 .optional()
-                .describe('Only setlists updated after this UTC time (format yyyyMMddHHmmss)'),
+                .describe('Only setlists updated on/after this UTC time, ISO yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss'),
             p: page,
         },
     }, async (args) => {
-        const data = await client.request('GET', '/1.0/search/setlists', { query: args });
+        const query = { ...args };
+        if (args.date)
+            query.date = isoToDmy(args.date);
+        if (args.lastUpdated)
+            query.lastUpdated = isoToCompactTimestamp(args.lastUpdated);
+        const data = await client.request('GET', '/1.0/search/setlists', { query });
         return textResult(data);
     });
     server.registerTool('setlist_get_setlist', {

package/dist/version.js

@@ -3,4 +3,4 @@
 // release-please-config.json's `extra-files`), and `versionSyncTest` guards
 // that it stays equal to package.json. Import VERSION wherever the version is
 // needed rather than re-declaring it.
-export const VERSION = '0.3.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "setlist-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "mcpName": "io.github.chrischall/setlist-mcp",
   "description": "setlist.fm MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -42,7 +42,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.5.2",
+    "@chrischall/mcp-utils": "^0.6.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.0",
     "zod": "^4.4.2"

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/setlist-mcp",
     "source": "github"
   },
-  "version": "0.3.0",
+  "version": "0.4.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "setlist-mcp",
-      "version": "0.3.0",
+      "version": "0.4.0",
       "transport": {
         "type": "stdio"
       },