Rootvine Mcp
rootvine-mcp
Cross-platform music link resolution for AI agents. Connects Claude, ChatGPT, and other AI agents to trusted music data via the Model Context Protocol.
What it does
When a user asks an AI agent "Where can I listen to Windowlicker by Aphex Twin?", RootVine resolves the query across all major streaming and purchase platforms and returns ranked results with direct links.
No ads. No sponsored placements. No pay-to-rank. Results are ranked by a neutral, deterministic algorithm: trust tier → price → availability → freshness → merchant ID.
Quick Start
Claude Desktop
Add to your Claude Desktop config (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"rootvine": {
"command": "npx",
"args": ["-y", "rootvine-mcp"]
}
}
}
Restart Claude Desktop. You can now ask:
- "Where can I stream Galway Girl by Ed Sheeran?"
- "Where can I listen to Windowlicker by Aphex Twin?"
- "Find links for the new Kendrick Lamar album"
Other MCP Clients
Any MCP-compatible client can use rootvine-mcp via stdio transport:
npx rootvine-mcp
Tools
resolve_music
Find where to listen to, buy, or stream a song or album.
Input: { slug: "ed-sheeran-galway-girl" }
Returns: Ranked results from Spotify, Apple Music, Amazon, iTunes, Bandcamp, YouTube Music, Deezer, Tidal, and more — with prices and direct links.
resolve_game (coming soon)
Game price resolution across Steam, PlayStation, Xbox, and more. This tool is registered but not yet active — it will return an error until the game vertical launches.
find_product
Smart router — currently routes all queries to the music resolver. Game routing will activate when the game vertical launches.
Input: { query: "Aphex Twin Windowlicker", category: "auto" }
Returns: Same as resolve_music.
Response Format
All results follow the RootVine v1 specification:
{
"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"
}
}
]
}
Roadmap
- ✅ Music — live now (Spotify, Apple Music, Amazon, YouTube, Deezer, Tidal, Bandcamp, and more)
- 🔜 Games — coming soon (Steam, PlayStation, Xbox, Epic, GOG)
Neutrality
RootVine follows a strict neutrality policy:
- Rankings are determined by trust tier → price → availability → freshness → merchant ID
- Commission rates, affiliate networks, and sponsored flags are architecturally excluded from the ranking function
- The ranking logic runs server-side — this package is a thin client
License
MIT — © Raging Orangutan Holdings
Server Config
{
"mcpServers": {
"rootvine": {
"command": "npx",
"args": [
"-y",
"rootvine-mcp"
]
}
}
}