SonoVault

Búsqueda de metadatos musicales: más de 90 millones de pistas, ISRC/ISWC, identificadores multiplataforma

Documentación

sonovault-mcp

Servidor MCP para la API de metadatos musicales SonoVault. Proporciona a Claude, Cursor y cualquier cliente MCP búsqueda en más de 93 millones de pistas, artistas, sellos y lanzamientos, con metadatos completos por resultado: género, sello, fechas de lanzamiento, créditos de artistas, códigos ISRC e ISWC, e identificadores multiplataforma (Spotify, Apple Music, Tidal, Beatport, Discogs, MusicBrainz, YouTube).

Pregúntale a tu asistente cosas como:

"¿Qué lanzamientos publicó mau5trap este año?"
"Encuentra Veridis Quo de Daft Punk y dame su género, sello e ISRC"
"Muéstrame la lista de pistas de Discovery con ISRC"
"¿Cuál es el ID de Spotify y Beatport para el ISRC GBDUW0000053?"
"Resuelve este registro de reproducción a ISRC y sellos" (pega hasta 100 líneas)
"Lista todas las grabaciones del ISWC T-071.020.439-9"

Configuración

Necesitas una clave de API de SonoVault. El plan gratuito incluye 1,000 solicitudes/mes, sin tarjeta de crédito: obtén una clave.

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Claude Code

claude mcp add sonovault -e SONOVAULT_API_KEY=svk_live_... -- npx -y sonovault-mcp

Cursor

Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en tu proyecto):

{
  "mcpServers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

VS Code (GitHub Copilot)

Añade a .vscode/mcp.json:

{
  "servers": {
    "sonovault": {
      "command": "npx",
      "args": ["-y", "sonovault-mcp"],
      "env": { "SONOVAULT_API_KEY": "svk_live_..." }
    }
  }
}

Windsurf

Añade el mismo bloque mcpServers que en Claude Desktop a ~/.codeium/windsurf/mcp_config.json.

Otros clientes MCP

Cualquier cliente que hable MCP sobre stdio funciona. Comando: npx -y sonovault-mcp con la variable de entorno SONOVAULT_API_KEY configurada.

Herramientas

Herramienta	Qué hace
`search_tracks`	Búsqueda difusa por artista + título. Devuelve ISRC, género, sello, fecha de lanzamiento.
`lookup_isrc`	Búsqueda exacta de grabación por ISRC.
`get_track`	Obtiene una pista por ID de SonoVault.
`get_work_codes`	De grabación a composición: los ISWC detrás de una grabación.
`get_recordings_of_work`	De composición a grabaciones: todas las grabaciones de un ISWC.
`get_platform_links`	El ID y enlace profundo de una pista en las 7 plataformas, desde cualquier ID o ISRC.
`resolve_tracks`	Resolución masiva de hasta 100 nombres de pistas, ISRC o IDs de plataforma.
`search_artists`, `get_artist_releases`	Búsqueda de artistas y discografía, con identificadores de Wikidata y MusicBrainz.
`search_labels`, `get_label_releases`	Búsqueda de sellos y catálogo.
`search_releases`, `get_release`	Búsqueda de lanzamientos, y listas de pistas con ISRC en orden de reproducción con números de disco y pista, además de IDs de lanzamiento y grupo de lanzamiento de MusicBrainz.
`list_genres`	La jerarquía canónica de géneros.
`browse_tracks`	Descubrimiento por sello, artista, género o año (plan de pago).

Todas las herramientas son de solo lectura. La mayoría funcionan en el plan gratuito; browse_tracks requiere un plan de pago.

Flujos de trabajo de ejemplo

Enriquecer un registro de reproducción de radio para informes de regalías

Pega un registro de reproducción con solo artista y título, y pregunta: "Resuelve estos a ISRC, álbum y sello, y dame una tabla que pueda mapear a un Informe de Uso de SoundExchange." El asistente llama a resolve_tracks una vez por cada 100 líneas y devuelve los identificadores que las sociedades de recaudación reconocen. Funciona igual para informes de PPL, Sena, GVL y Re:Sound.

Limpiar una biblioteca de DJ

"Aquí hay 50 pistas de mi exportación de rekordbox. Encuentra la versión canónica de cada una, marca los duplicados que comparten un ISRC, y etiqueta cada una con su género." El asistente combina resolve_tracks con los campos de género de cada resultado.

Conectar grabaciones con composiciones

"Tengo ISRC de mi distribuidor. ¿A qué obras musicales pertenecen, y qué otras grabaciones existen de cada obra?" El asistente encadena get_work_codes y get_recordings_of_work. Útil para administración editorial e investigación de versiones/covers.

Verificar disponibilidad multiplataforma

"¿Está este exclusivo de Beatport ya en Spotify? ID de Beatport 6014288." Una llamada a get_platform_links lo responde, con enlaces profundos por plataforma.

Investigar un sello

"Resume lo que Anjunabeats lanzó en los últimos seis meses, agrupado por subgénero." El asistente recorre get_label_releases y extrae el género de las listas de pistas.

Preguntas frecuentes

¿Hay un plan gratuito?

Sí. Una clave gratuita de SonoVault incluye 1,000 solicitudes/mes sin tarjeta de crédito. Todas las herramientas excepto browse_tracks funcionan con ella.

¿Qué metadatos incluye cada pista?

Título, créditos de artistas (con indicadores de artista principal/remixador), ISRC, duración, género y subgénero, y por lanzamiento: título del álbum, sello y fecha de lanzamiento. Los códigos de obra ISWC provienen de las herramientas dedicadas de códigos de obra.

¿Devuelve BPM o tonalidad musical?

No. La API pública de SonoVault excluye deliberadamente características de audio como BPM, tonalidad y energía. Tampoco hay vistas previas de audio ni carátulas.

¿De dónde provienen los datos?

Agregados y deduplicados de MusicBrainz, Discogs, Spotify, Apple Music, Tidal y Beatport, con enlaces ISWC de The MLC. Detalles: sonovault.now/data-sources.

¿En qué se diferencia de una integración con la API de Spotify?

Las APIs de una sola plataforma devuelven solo sus propios IDs. SonoVault resuelve una grabación a sus IDs en las siete plataformas compatibles, claveados por ISRC, y añade identificadores (ISRC, ISWC) que las APIs de plataforma no exponen. Comparación: sonovault.now/compare/spotify-api.

¿Se envía mi clave de API a algún lugar además de SonoVault?

No. El servidor se ejecuta localmente sobre stdio y envía tu clave solo a api.sonovault.now como encabezado de solicitud. El código es pequeño y auditable: src/server.ts.

Habilidad de Agente

¿No usas MCP? skill/SKILL.md es una Habilidad de Agente que enseña a cualquier agente a llamar a la API de SonoVault directamente por HTTP: reglas de búsqueda, recetas de ISRC/ISWC, resolución masiva y manejo de errores.

Relacionados

Documentación de la API de SonoVault
sonovault-js y sonovault-python, los SDK de cliente (este servidor está construido sobre sonovault-js)

Licencia

MIT