RootVine

Resolución de enlaces musicales multiplataforma para agentes de IA. Conecta Claude, ChatGPT y otros agentes de IA a datos musicales confiables a través del Protocolo de Contexto de Modelo.

GitHub
3
Prueba este MCPPatrocinado

Documentación

rootvine-mcp

Una capa de resolución comercial neutral para agentes de IA. Conecta a Claude, ChatGPT y otros agentes de IA con datos confiables de productos y medios a través del Protocolo de Contexto de Modelo — cubriendo todo el recorrido, desde streaming hasta ediciones de colección.

Qué hace

Cuando un usuario le pregunta a un agente de IA "¿Dónde puedo escuchar Windowlicker de Aphex Twin?", RootVine resuelve la consulta en todas las principales plataformas de streaming, compra y medios físicos, y devuelve resultados clasificados con enlaces directos.

La misma infraestructura responde a toda la escalera de compra: transmitirlo, comprarlo digitalmente o encontrar el vinilo. La música está disponible hoy. Los juegos, libros, películas, podcasts y eventos en vivo se están implementando a medida que sus verticales se lanzan.

Sin anuncios. Sin colocaciones patrocinadas. Sin pago por posicionamiento. Los resultados se clasifican mediante un algoritmo neutral y determinista: nivel de confianza → precio → disponibilidad → novedad → ID de comerciante. Las tasas de comisión, las redes de afiliados y los indicadores de patrocinio están excluidos arquitectónicamente de la función de clasificación.

Inicio rápido

Alojado — sin nada que instalar

RootVine funciona como un servidor MCP alojado y transmisible por HTTP:

https://mcp.rootvine.ai/mcp

Agrégalo por URL en cualquier cliente que acepte un servidor MCP remoto — por ejemplo, en claude.ai: Configuración → Conectores → Agregar conector personalizado. Sin inicio de sesión, sin clave. Las mismas cinco herramientas que el paquete npm, respondiendo desde las mismas fuentes en vivo.

Claude Desktop (local, vía npm)

Agrega a tu configuración de Claude Desktop (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "rootvine": {
      "command": "npx",
      "args": ["-y", "rootvine-mcp"]
    }
  }
}

Reinicia Claude Desktop. Ahora puedes preguntar:

  • "¿Dónde puedo transmitir Galway Girl de Ed Sheeran?"
  • "¿Dónde puedo escuchar Windowlicker de Aphex Twin?"
  • "Busca enlaces para el nuevo álbum de Kendrick Lamar"

Otros clientes MCP

Cualquier cliente compatible con MCP puede usar rootvine-mcp mediante transporte stdio:

npx rootvine-mcp

Herramientas

Pasa las propias palabras del usuario como query — "galway girl de ed sheeran", "qué álbumes ha lanzado Stromae". Nunca construyas slugs: RootVine encuentra la página. slug sigue funcionando como un alias obsoleto para query (envía uno u otro, no ambos).

resolve_music

Encuentra dónde transmitir, comprar o coleccionar una canción o álbum.

Entrada: { query: "galway girl by ed sheeran" } — las palabras del usuario, una dirección de página de BeatsVine o un valor de query de una respuesta anterior.

Devuelve: Resultados clasificados que cubren:

  • Streaming — Spotify, Apple Music, Tidal, YouTube Music, Deezer
  • Compra digital — iTunes Store, Amazon Music, Bandcamp
  • Medios físicos — vinilo, CD (vía Amazon), listados de coleccionistas de Discogs

Cada resultado incluye precios (cuando están disponibles), enlaces directos y URL de clic con etiqueta de afiliado para seguimiento.

Cómo se encuentra la página: RootVine busca en el catálogo de BeatsVine con las palabras que importan (las palabras de solicitud como "dónde puedo transmitir" y palabras de conexión como "de" se dejan de lado) y abre la mejor coincidencia. Un error tipográfico va a la búsqueda en vivo de BeatsVine, que lo corrige; RootVine luego abre la página real y lo indica en resolved_as (corrected: true). Una suposición débil nunca se presenta como la respuesta: un fallo devuelve status: "no_results" con did_you_mean — coincidencias cercanas, cada una con un query para devolver. Un título grabado por varios artistas, preguntado sin artista ("shape of you"), devuelve esas grabaciones para elegir en lugar de una elegida al azar.

resolve_artist

Obtén el perfil de un artista y su discografía completa.

Entrada: { query: "Stromae" } — el nombre, una dirección de artista de BeatsVine o artist/stromae

Devuelve: Géneros, metadatos del artista y cada lanzamiento que BeatsVine tenga, cada uno con un query listo para resolve_music:

resolve_artist { query: "Stromae" }
  → 19 releases, e.g. album/stromae-racine-carre

resolve_music { query: "album/stromae-racine-carre" }
  → stream, purchase and physical-media links

Los formatos físicos — vinilo, CD, listados de Discogs — son productos a nivel de álbum, por lo que esta es la ruta a las ediciones de colección. Un nombre mal escrito devuelve did_you_mean en lugar de una suposición.

Dos campos de respuesta que vale la pena manejar:

  • discography_complete: false (el not_yet_indexed de BeatsVine) significa que BeatsVine aún no ha catalogado a este artista. Una lista vacía entonces significa desconocido, no sin lanzamientos — el texto lo dice explícitamente en lugar de implicar una discografía vacía.
  • sparse_fallback_applied significa que se incluyeron sencillos porque la lista de álbumes era escasa. Esa es la elección de presentación de BeatsVine, que se muestra para que no se confunda con el propio encuadre del artista.

discover_music

Explora colecciones musicales curadas — listas de éxitos, muros de género, estados de ánimo, playlists editoriales, destacados de artistas y listas históricas desde 1946.

Entrada: { chamber?: "by-genre" | "for-this-moment" | "charts" | "by-era" | "spotlights", wall?: string, year?: number, limit?: number, resolve?: boolean }

Modos (elegidos según qué argumento esté configurado):

  • Vestíbulo (sin argumentos) — vista general de todas las cámaras y muros destacados
  • Cámara (argumento chamber) — lista de muros dentro de una cámara (por ejemplo, todos los corredores de género)
  • Muro (argumento wall: un slug, walls/slug o la dirección del muro) — profundiza en las pistas, álbumes o artistas de un muro específico
  • Archivo (argumento year) — instantáneas de listas congeladas de cualquier año desde 1946

Devuelve: Colecciones curadas con atribución honesta (por ejemplo, "Curado por el equipo editorial de Deezer", "Basado en scrobbles de Last.fm"). Cada entrada lleva un query que resolve_music convierte en enlaces de streaming y compra.

Respondiendo a "qué era el número uno cuando nací — y dónde puedo conseguirlo":

discover_music { year: 1994 }                                       → bv-year-end-hot-100-1994 (100 entries)
discover_music { wall: "bv-year-end-hot-100-1994", resolve: true }  → number one = Ace of Base, "The Sign", with its links

resolve: true obtiene la página que la propia lista nombra para el número uno — sin búsqueda, sin nombre adivinado. Si esos enlaces son lentos, la lista igual regresa, con una nota.

Archivos: el Billboard Hot 100 de fin de año de EE. UU. completo, desde 1946, más instantáneas semanales de las listas en vivo. Las listas de fin de año del Reino Unido muestran solo su número uno, con un enlace a la lista completa en officialcharts.com (la compilación de Official Charts Company está protegida por derecho de base de datos); cada muro lo indica en su campo publication. Los muros globales de año y década reflejan la lista de Billboard de EE. UU.

find_product

Enrutador inteligente — lee la categoría de las palabras del usuario y enruta al resolutor correcto.

Entrada: { query: "Aphex Twin Windowlicker", category: "auto" }

La detección se basa en palabras clave: las palabras de música ("álbum", "vinilo", "canción", "de"…) ganan sobre las palabras de juegos, por lo que "Abbey Road edición de lujo en vinilo" es música. Configura category cuando lo sepas.

Devuelve: la respuesta de la herramienta elegida. Resultados de música hoy (streaming, compra digital, vinilo, CD, ediciones de colección); los juegos responden "próximamente". Los libros, películas, podcasts y entradas para eventos en vivo se enrutarán automáticamente a medida que cada vertical se lance.

resolve_game (próximamente)

Resolución de precios de juegos en Steam, PlayStation, Xbox, Nintendo, Epic, GOG, Humble y Fanatical. Esta herramienta está registrada pero aún no activa — devuelve un "próximamente" explícito (sin enlaces, sin precios, sin solicitud realizada) hasta que la vertical de juegos se lance.

Formato de respuesta

RootVine nunca inventa. Cada enlace existió en resolved_at.

Cada respuesta viene dos veces: texto legible y structuredContent (salida estructurada MCP) con los mismos datos, para que un agente lea campos en lugar de analizar prosa. Los fallos son errores de texto plano (isError); un fallo es una respuesta (no_results), no un error.

Una respuesta de resolve_music, abreviada:

{
  "status": "success",
  "artist": "Ed Sheeran",
  "title": "Galway Girl",
  "kind": "track",
  "results": [
    {
      "rank": 1,
      "merchant": "Spotify",
      "type": "stream",
      "trust_tier": "authoritative",
      "availability": "available",
      "price": null,
      "click_url": "https://www.beatsvine.com/r/abc123",
      "url": "https://open.spotify.com/track/...",
      "ranking_reason": { "code": "FREE_STREAM_T1", "summary": "Stream with no listed price, Tier 1" }
    }
  ],
  "partial_sources": [],
  "warnings": [],
  "resolved_as": { "query": "ed-sheeran-galway-girl", "via": "catalogue_search", "corrected": false, "note": null },
  "did_you_mean": [],
  "page_url": "https://www.beatsvine.com/ed-sheeran-galway-girl",
  "response_id": "rv_resp_...",
  "resolved_at": "2026-09-26T12:00:00.000Z",
  "ttl_seconds": 86400
}
  • status es success, partial (real pero incompleto — partial_sources nombra lo que no respondió) o no_results.
  • Un precio faltante es null — nunca cero, nunca "gratis".
  • page_url se da solo cuando se confirma que la página de BeatsVine existe.
  • Límites: tiendas centradas en el Reino Unido, precios en GBP; solo música hoy.

Hoja de ruta

  • ✅ Resolución de música — en vivo (streaming, compra digital, vinilo, CD, ediciones de colección en Spotify, Apple Music, iTunes, Amazon, Bandcamp, Discogs, YouTube Music, Tidal, Deezer y más)
  • ✅ Descubrimiento de música — en vivo (explora listas, muros de género, colecciones de estado de ánimo, playlists editoriales, destacados de artistas)
  • ✅ Archivos de listas — en vivo (instantáneas congeladas de listas de fin de año y semanales desde 1946 — Billboard Hot 100, Top 100 Global, Sencillos del Reino Unido)
  • ✅ Discografía de artistas — en vivo (perfiles de artistas y listas completas de lanzamientos, cada uno resoluble a enlaces de transmitir/comprar/coleccionar)
  • 🔜 Eventos en vivo — entradas para conciertos, recitales y festivales
  • 🔜 Juegos — claves digitales, copias físicas y ediciones de colección (Steam, PlayStation, Xbox, Nintendo, Epic, GOG)
  • 🔜 Libros — ebook, audiolibro, tapa blanda, tapa dura y ediciones especiales (Amazon, Bookshop.org, Apple Books, Kobo, Audible)
  • 🔜 Películas y TV — streaming, alquiler, compra digital, DVD, Blu-ray y steelbook 4K
  • 🔜 Podcasts — enlaces de escucha en Apple Podcasts, Spotify, Pocket Casts y más

Neutralidad

RootVine sigue una política de neutralidad estricta:

  • Las clasificaciones se determinan por nivel de confianza → precio → disponibilidad → novedad → ID de comerciante
  • Las tasas de comisión, las redes de afiliados y los indicadores de patrocinio están excluidos arquitectónicamente de la función de clasificación
  • La lógica de clasificación se ejecuta en el servidor — este paquete es un cliente ligero

Licencia

MIT — © Raging Orangutan Holdings