sonovault-mcp 1.0.4 → 1.1.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
@@ -93,7 +93,7 @@ Any client that speaks MCP over stdio works. Command: `npx -y sonovault-mcp` wit
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
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. |
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. |
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.0.4";
11
+ var SERVER_VERSION = "1.1.0";
12
12
  function json(data) {
13
13
  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
14
14
  }
@@ -190,10 +190,13 @@ function createServer(sv2) {
190
190
  "get_release",
191
191
  {
192
192
  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. Also returns musicbrainz_release_ids and musicbrainz_release_group_ids: arrays, because a SonoVault release groups every edition of an album and each edition has its own MBID.",
194
- inputSchema: { id: z.number().int().describe("SonoVault release ID") }
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.",
194
+ inputSchema: {
195
+ id: z.number().int().describe("SonoVault release ID"),
196
+ 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.")
197
+ }
195
198
  },
196
- wrap(async ({ id }) => sv2.releases.get(id))
199
+ wrap(async ({ id, edition }) => sv2.releases.get(id, { edition }))
197
200
  );
198
201
  server2.registerTool(
199
202
  "list_genres",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sonovault-mcp",
3
- "version": "1.0.4",
3
+ "version": "1.1.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": "^3.0.0",
46
+ "sonovault": "^4.1.0",
47
47
  "zod": "^3.25.0"
48
48
  },
49
49
  "devDependencies": {