sonovault-mcp 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -92,8 +92,8 @@ Any client that speaks MCP over stdio works. Command: `npx -y sonovault-mcp` wit
92
92
  | `get_platform_links` | One track's ID and deep link on all 7 platforms, from any ID or ISRC. |
93
93
  | `resolve_tracks` | Bulk resolve up to 100 track names, ISRCs, or platform IDs. |
94
94
  | `search_artists`, `get_artist_releases` | Artist search and discography, with Wikidata and MusicBrainz identifiers. |
95
- | `search_labels`, `get_label_releases` | Label search and catalog. |
96
- | `search_releases`, `get_release` | Release search, and tracklists with ISRCs in playing order with disc and track numbers, plus MusicBrainz release and release-group ids. `get_release` also lists the real editions behind a release and takes an `edition` id to render that edition's numbering. |
95
+ | `search_labels`, `get_label_releases` | Label search and catalog, optionally for one release date or a date range. |
96
+ | `search_releases`, `get_release` | Release search, and tracklists with ISRCs in playing order with disc and track numbers, plus MusicBrainz release and release-group ids. `get_release` also lists the real editions behind a release, each with its own label and catalog number, and takes an `edition` id to render that edition's numbering. |
97
97
  | `list_genres` | The canonical genre hierarchy. |
98
98
  | `browse_tracks` | Discover by label, artist, genre, or year (paid tier). |
99
99
 
package/dist/index.js CHANGED
@@ -8,7 +8,7 @@ import { SonoVault as SonoVault2 } from "sonovault";
8
8
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
9
9
  import { SonoVaultError } from "sonovault";
10
10
  import { z } from "zod";
11
- var SERVER_VERSION = "1.1.0";
11
+ var SERVER_VERSION = "1.2.0";
12
12
  function json(data) {
13
13
  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
14
14
  }
@@ -16,6 +16,7 @@ function toolError(err) {
16
16
  const message = err instanceof SonoVaultError ? `SonoVault API error (HTTP ${err.status}): ${err.message}` + (err.isForbidden ? " (this endpoint needs a paid SonoVault tier)" : "") + (err.isAuthError ? " (check SONOVAULT_API_KEY)" : "") : `Error: ${err.message}`;
17
17
  return { content: [{ type: "text", text: message }], isError: true };
18
18
  }
19
+ var DATE = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Expected YYYY-MM-DD");
19
20
  function wrap(fn) {
20
21
  return async (...args) => {
21
22
  try {
@@ -139,14 +140,16 @@ function createServer(sv2) {
139
140
  "get_artist_releases",
140
141
  {
141
142
  title: "Artist releases",
142
- description: "An artist's releases, newest first. Use the cursor from a previous call for the next page.",
143
+ description: "An artist's releases, newest first. Use the cursor from a previous call for the next page. Optional from/until (YYYY-MM-DD, inclusive) limit it to a release-date range.",
143
144
  inputSchema: {
144
145
  artist_id: z.number().int().describe("SonoVault artist ID (from search_artists)"),
145
146
  limit: z.number().int().min(1).max(100).optional(),
146
- cursor: z.string().optional().describe("next_cursor from the previous page")
147
+ cursor: z.string().optional().describe("next_cursor from the previous page"),
148
+ from: DATE.optional().describe("Only releases dated on or after this day (YYYY-MM-DD)"),
149
+ until: DATE.optional().describe("Only releases dated on or before this day (YYYY-MM-DD)")
147
150
  }
148
151
  },
149
- wrap(async ({ artist_id, limit, cursor }) => sv2.artists.releases(artist_id, { limit, cursor }))
152
+ wrap(async ({ artist_id, limit, cursor, from, until }) => sv2.artists.releases(artist_id, { limit, cursor, from, until }))
150
153
  );
151
154
  server2.registerTool(
152
155
  "search_labels",
@@ -164,14 +167,16 @@ function createServer(sv2) {
164
167
  "get_label_releases",
165
168
  {
166
169
  title: "Label releases",
167
- description: "A label's releases, newest first, with artist per release. Cursor-paginated.",
170
+ description: "A label's releases, newest first, with artist per release. Cursor-paginated. Optional from/until (YYYY-MM-DD, inclusive) limit it to a release-date range; pass the same day for both to see what the label released that day.",
168
171
  inputSchema: {
169
172
  label_id: z.number().int().describe("SonoVault label ID (from search_labels)"),
170
173
  limit: z.number().int().min(1).max(100).optional(),
171
- cursor: z.string().optional()
174
+ cursor: z.string().optional(),
175
+ from: DATE.optional().describe("Only releases dated on or after this day (YYYY-MM-DD)"),
176
+ until: DATE.optional().describe("Only releases dated on or before this day (YYYY-MM-DD)")
172
177
  }
173
178
  },
174
- wrap(async ({ label_id, limit, cursor }) => sv2.labels.releases(label_id, { limit, cursor }))
179
+ wrap(async ({ label_id, limit, cursor, from, until }) => sv2.labels.releases(label_id, { limit, cursor, from, until }))
175
180
  );
176
181
  server2.registerTool(
177
182
  "search_releases",
@@ -190,7 +195,7 @@ function createServer(sv2) {
190
195
  "get_release",
191
196
  {
192
197
  title: "Get release with tracklist",
193
- description: "Fetch one release by SonoVault release ID, including its full tracklist with ISRCs. Tracks come back in playing order, each with disc_number and track_number; a track whose position is unknown sorts last with both null. A SonoVault release groups every edition of an album onto one record, so the response also carries an editions array naming the real editions behind it, each with its provider, format, release date, barcode, country and track count; pass one of their ids as `edition` to render that edition's numbering instead of the default consensus. musicbrainz_release_ids and musicbrainz_release_group_ids are arrays for the same reason.",
198
+ description: "Fetch one release by SonoVault release ID, including its full tracklist with ISRCs. Tracks come back in playing order, each with disc_number and track_number; a track whose position is unknown sorts last with both null. A SonoVault release groups every edition of an album onto one record, so the response also carries an editions array naming the real editions behind it, each with its provider, format, release date, barcode, country, track count, label and catalog number (pressings of one album often carry different labels); pass one of their ids as `edition` to render that edition's numbering instead of the default consensus. musicbrainz_release_ids and musicbrainz_release_group_ids are arrays for the same reason.",
194
199
  inputSchema: {
195
200
  id: z.number().int().describe("SonoVault release ID"),
196
201
  edition: z.number().int().optional().describe("Edition id from the response's editions array. Renders that edition's track numbering; tracks it does not carry keep a null position and come last.")
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sonovault-mcp",
3
- "version": "1.1.0",
3
+ "version": "1.2.0",
4
4
  "description": "MCP server for the SonoVault music metadata API. Search 93M+ tracks, artists, and releases; get genre, label, release dates, ISRC/ISWC codes, and cross-platform IDs.",
5
5
  "mcpName": "io.github.rekordcloud/sonovault",
6
6
  "keywords": [
@@ -43,7 +43,7 @@
43
43
  },
44
44
  "dependencies": {
45
45
  "@modelcontextprotocol/sdk": "^1.29.0",
46
- "sonovault": "^4.1.0",
46
+ "sonovault": "^4.2.0",
47
47
  "zod": "^3.25.0"
48
48
  },
49
49
  "devDependencies": {