rootvine-mcp

Una capa de resolución de comercio neutral para agentes de IA. Conecta a Claude, ChatGPT y otros agentes de IA con datos de productos y medios confiables a través del Model Context Protocol, cubriendo cada camino desde el streaming hasta las ediciones de coleccionista.

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 físicas, y devuelve resultados clasificados con enlaces directos.

La misma infraestructura responde a toda la cadena 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 irán incorporando a medida que sus verticales se lancen.

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

Inicio rápido

Claude Desktop

Agrégalo 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?"

• "Encuentra enlaces para el nuevo álbum de Kendrick Lamar"

Otros clientes MCP

Cualquier cliente compatible con MCP puede usar rootvine-mcp a través del transporte stdio:

npx rootvine-mcp

Herramientas

discover_music

Explora colecciones de música seleccionadas: listas de éxitos, muros de géneros, estados de ánimo, listas de reproducción editoriales y destacados de artistas.

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

Modos (elegidos según qué argumento se establezca):

• Foyer (sin argumentos) — descripción general de todas las cámaras y muros destacados

• Chamber (argumento chamber) — lista de muros dentro de una cámara (p. ej., todos los pasillos de género)

• Wall (argumento wall) — profundiza en las pistas, álbumes o artistas de un muro específico

Devuelve: Colecciones seleccionadas con atribución honesta (p. ej., "Curado por el equipo editorial de Deezer", "Basado en scrobbles de Last.fm"). Cada entrada enlaza a una página de BeatsVine cuyos enlaces de streaming y compra se pueden recuperar mediante resolve_music.

resolve_music

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

Entrada: { slug: "ed-sheeran-galway-girl" }

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 coleccionista de Discogs

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

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 está activa; devolverá una respuesta de "próximamente" hasta que se lance la vertical de juegos.

find_product

Enrutador inteligente: detecta automáticamente la categoría y enruta al resolvedor correcto.

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

Devuelve: Resultados de música hoy (streaming, compra digital, vinilo, CD, ediciones de coleccionista). Los juegos, libros, películas, podcasts y entradas para eventos en vivo se enrutarán automáticamente a medida que se lance cada vertical.

Formato de respuesta

Todos los resultados siguen la especificación RootVine v1:

{
  "rootvine": {
    "version": "1.0",
    "resolver": "beatsvine",
    "category": "music"
  },
  "status": "success",
  "query": {
    "type": "music",
    "artist": "Aphex Twin",
    "title": "Windowlicker"
  },
  "results": [
    {
      "rank": 1,
      "merchant": "Spotify",
      "trust_tier": "authoritative",
      "price": null,
      "url": "https://open.spotify.com/track/...",
      "click_url": "https://beatsvine.com/r/abc123",
      "type": "stream",
      "ranking_reason": {
        "code": "FREE_STREAM_T1",
        "summary": "Free stream from authoritative source"
      }
    }
  ]
}

Hoja de ruta

• ✅ Resolución de música — activo (streaming, compra digital, vinilo, CD, ediciones de coleccionista en Spotify, Apple Music, iTunes, Amazon, Bandcamp, Discogs, YouTube Music, Tidal, Deezer y más)

• ✅ Descubrimiento de música — activo (explorar listas de éxitos, muros de géneros, colecciones de estados de ánimo, listas de reproducción editoriales, destacados de artistas)

• 🔜 Juegos — claves digitales, copias físicas y ediciones de coleccionista (Steam, PlayStation, Xbox, Nintendo, Epic, GOG)

• 🔜 Libros — libro electrónico, 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

• 🔜 Eventos en vivo — entradas para conciertos, actuaciones y festivales (Ticketmaster, Dice, See Tickets)

Neutralidad

RootVine sigue una estricta política de neutralidad:

• Las clasificaciones están determinadas por nivel de confianza → precio → disponibilidad → frescura → ID del comerciante

• Las tasas de comisión, las redes de afiliados y las etiquetas de patrocinio están excluidas arquitectónicamente de la función de clasificación

• La lógica de clasificación se ejecuta en el lado del servidor; este paquete es un cliente ligero

Licencia

MIT — © Raging Orangutan Holdings