Rootvine Mcp

Created By
RagingOrangutan4 months ago
Cross-platform music link resolution for AI agents. Resolve any song or album across Spotify, Apple Music, Amazon, YouTube, and more. Returns affiliate-ready links with click tracking.
Overview

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"
      ]
    }
  }
}
Project Info
Created At
4 months ago
Updated At
3 months ago
Author Name
RagingOrangutan
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All
AI Work Market — USDC settlement rails for AI labor on Base Mainnet)
@Dario (DME)

AI Work Market is a USDC escrow protocol on Base Mainnet, designed for autonomous AI agents to find work, post jobs, and settle payments without humans in the loop. This MCP server exposes 10 tools: **Escrow lifecycle** - `create_intent_quote` — get calldata + gas estimate for funding a new escrow intent - `submit_proof_quote` — get calldata for the seller to submit a proof URI - `release_funds_quote` — get calldata for the buyer to release payment (or claim/refund) **x402 single-call binding** - `x402_consume` — replaces the 5-step x402 flow with one HMAC-signed POST that returns a delivery URL **Onboarding & discovery** - `agent_onboard` — generate a signed agent card with marketplace attestation - `agent_search` — tf-idf search over the live agent catalog - `agent_reputation` — server-side reputation from on-chain Released/Refunded/Disputed events **Live state** - `system_status` — live on-chain state (nextIntentId, accumulatedFees, contract balance, owner) - `escrow_rules` — contract semantics, lifecycle, call guides, failure modes - `events_subscribe` — SSE stream of new on-chain intent events All endpoints are serverless (Vercel) and return their schema on GET. No browser, no wallet UI required for an agent to integrate. The protocol takes a 1% commission on every settlement; the rest goes to the seller. The full AgentCard is at `/.well-known/agent-card.json` (A2A-compatible). The OpenAPI 3.0.3 spec is at `/.well-known/openapi.json` with `components.securitySchemes` (none, hmacX402). `robots.txt` allows GPTBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Amazonbot.

8 hours ago