sonovault-mcp 1.0.2 → 1.0.4

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
@@ -3,7 +3,7 @@
3
3
  [![CI](https://github.com/rekordcloud/sonovault-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/rekordcloud/sonovault-mcp/actions/workflows/ci.yml)
4
4
  [![npm](https://img.shields.io/npm/v/sonovault-mcp)](https://www.npmjs.com/package/sonovault-mcp)
5
5
 
6
- MCP server for the **[SonoVault](https://sonovault.now)** music metadata API. Gives Claude, Cursor, and any MCP client search across 90M+ tracks, artists, labels, and releases, with full metadata per result: genre, label, release dates, artist credits, ISRC and ISWC codes, and cross-platform IDs (Spotify, Apple Music, Tidal, Beatport, Discogs, MusicBrainz, YouTube).
6
+ MCP server for the **[SonoVault](https://sonovault.now)** music metadata API. Gives Claude, Cursor, and any MCP client search across 93M+ tracks, artists, labels, and releases, with full metadata per result: genre, label, release dates, artist credits, ISRC and ISWC codes, and cross-platform IDs (Spotify, Apple Music, Tidal, Beatport, Discogs, MusicBrainz, YouTube).
7
7
 
8
8
  Ask your assistant things like:
9
9
 
@@ -91,9 +91,9 @@ Any client that speaks MCP over stdio works. Command: `npx -y sonovault-mcp` wit
91
91
  | `get_recordings_of_work` | Composition to recordings: every recording of an ISWC. |
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
- | `search_artists`, `get_artist_releases` | Artist search and discography. |
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. |
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. |
97
97
  | `list_genres` | The canonical genre hierarchy. |
98
98
  | `browse_tracks` | Discover by label, artist, genre, or year (paid tier). |
99
99
 
@@ -147,6 +147,10 @@ Single-platform APIs return their own IDs only. SonoVault resolves one recording
147
147
 
148
148
  No. The server runs locally over stdio and sends your key only to `api.sonovault.now` as a request header. The code is small and auditable: [src/server.ts](src/server.ts).
149
149
 
150
+ ## Agent Skill
151
+
152
+ Not using MCP? [`skill/SKILL.md`](skill/SKILL.md) is an [Agent Skill](https://agentskills.io/) that teaches any agent to call the SonoVault API directly over HTTP: search rules, ISRC/ISWC recipes, bulk resolution, and error handling.
153
+
150
154
  ## Related
151
155
 
152
156
  - [SonoVault API docs](https://sonovault.now/docs)
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.2";
11
+ var SERVER_VERSION = "1.0.4";
12
12
  function json(data) {
13
13
  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
14
14
  }
@@ -31,7 +31,7 @@ function createServer(sv2) {
31
31
  "search_tracks",
32
32
  {
33
33
  title: "Search tracks",
34
- description: "Search the SonoVault catalog (90M+ tracks) by artist and title. Both are required; there is no free-text search. Returns ISRC, genre, duration, artist credits, and release info (album, label, release date) per track.",
34
+ description: "Search the SonoVault catalog (93M+ tracks) by artist and title. Both are required; there is no free-text search. Returns ISRC, genre, duration, artist credits, and release info (album, label, release date) per track.",
35
35
  inputSchema: {
36
36
  artist: z.string().describe("Artist name, e.g. 'Daft Punk'"),
37
37
  title: z.string().describe("Track title, e.g. 'One More Time'"),
@@ -127,7 +127,7 @@ function createServer(sv2) {
127
127
  "search_artists",
128
128
  {
129
129
  title: "Search artists",
130
- description: "Search artists by name. Returns id, name, country, formation year, and release count.",
130
+ description: "Search artists by name. Returns id, name, country, formation year, release count, and the wikidata_id and musicbrainz_id identifiers for joining against external datasets.",
131
131
  inputSchema: {
132
132
  name: z.string().describe("Artist name to search for"),
133
133
  limit: z.number().int().min(1).max(100).optional()
@@ -190,7 +190,7 @@ 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.",
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
194
  inputSchema: { id: z.number().int().describe("SonoVault release ID") }
195
195
  },
196
196
  wrap(async ({ id }) => sv2.releases.get(id))
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "sonovault-mcp",
3
- "version": "1.0.2",
4
- "description": "MCP server for the SonoVault music metadata API. Search 90M+ tracks, artists, and releases; get genre, label, release dates, ISRC/ISWC codes, and cross-platform IDs.",
3
+ "version": "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": [
7
7
  "mcp",
@@ -43,7 +43,7 @@
43
43
  },
44
44
  "dependencies": {
45
45
  "@modelcontextprotocol/sdk": "^1.29.0",
46
- "sonovault": "^1.2.0",
46
+ "sonovault": "^3.0.0",
47
47
  "zod": "^3.25.0"
48
48
  },
49
49
  "devDependencies": {