# rootvine-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/RagingOrangutan/rootvine-mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 1122  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rootvine-mcp

## Description
Cross-platform music and game resolution for AI agents across 15+ platforms.

## Tools
Capabilities this server exposes over MCP:

- **resolve_music** — Live stream, buy and collect links for a song or album — streaming services, digital stores, vinyl and CD — ranked by trust, price and availability, never by commission. Call it rather than recall: links and prices change; a guessed link 404s. Pass the user's words as `query` ("galway girl by ed sheeran"); never build slugs. On a miss, `did_you_mean` lists close matches, each with a `query` to pass back; when `resolved_as.corrected` is true, tell the user which recording is shown. RootVine never fabricates. Every link existed at resolved_at. Limits: UK-focused stores, prices in GBP; music only today — games are not live yet. On partial, say which sources didn't answer; on no_results, tell the user plainly — never fall back to guessing a link.
- **resolve_game** — Where to buy a video game. Not live yet: every call returns an explicit "coming soon" — no links, no prices — and contacts no store. Tell the user plainly that games aren't supported yet; never guess a store link or a price. For music, use resolve_music. RootVine never fabricates. Every link existed at resolved_at. Limits: UK-focused stores, prices in GBP; music only today — games are not live yet. On partial, say which sources didn't answer; on no_results, tell the user plainly — never fall back to guessing a link.
- **find_product** — Start here when the category is unclear. Pass the user's words as `query`; RootVine reads music or games from them (keyword-based — set `category` when you know it) and answers in that tool's shape. Music is live; games answer "coming soon" for now. RootVine never fabricates. Every link existed at resolved_at. Limits: UK-focused stores, prices in GBP; music only today — games are not live yet. On partial, say which sources didn't answer; on no_results, tell the user plainly — never fall back to guessing a link.
- **resolve_artist** — An artist's live profile and discography from BeatsVine, for "what else has X made" or "X's albums". Each release has a `query` to pass to resolve_music for its links; vinyl, CD and collector editions are album-level, so this is the route to them. Pass the artist's name as `query`. `discography_complete: false` means not yet indexed — unknown, not empty. RootVine never fabricates. Every link existed at resolved_at. Limits: UK-focused stores, prices in GBP; music only today — games are not live yet. On partial, say which sources didn't answer; on no_results, tell the user plainly — never fall back to guessing a link.
- **discover_music** — Browse live charts, genre and mood walls, editorial playlists, artist spotlights, and chart snapshots back to 1946 — "what's trending", "number one in 1994". Charts move weekly: call rather than recall. No arguments gives the chambers and featured walls; `year` gives that year's snapshots; `wall` gives its entries, each with a `query` for resolve_music. Add `resolve: true` with `wall` to get number one's links in the same call. RootVine never fabricates. Every link existed at resolved_at. Limits: UK-focused stores, prices in GBP; music only today — games are not live yet. On partial, say which sources didn't answer; on no_results, tell the user plainly — never fall back to guessing a link.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What rootvine-mcp MCP server does

The rootvine-mcp MCP server gives AI agents a way to locate music across streaming services, digital stores, and physical-media marketplaces. It works with BeatsVine’s catalogue and returns direct links, prices where available, availability details, ranking information, and timestamps for resolved results.

Its current active coverage is music. Streaming results can include Spotify, Apple Music, Tidal, YouTube Music, and Deezer. Digital purchase results can include iTunes Store, Amazon Music, and Bandcamp. Physical-media results include vinyl and CD listings through Amazon and collector listings from Discogs.

The server also supports artist and catalogue exploration. An artist lookup returns profile information, genres, and releases with follow-up queries that can be passed to music resolution. Discovery requests expose curated collections such as genre walls, moods, charts, editorial playlists, artist spotlights, and historical charts reaching back to 1946.

## How it works

The rootvine-mcp MCP server accepts the user’s natural-language wording through a `query` field. Callers should provide phrases such as a song title and artist, rather than constructing catalogue slugs. BeatsVine searches for the best match, corrects some misspellings, and reports corrections in the response. Ambiguous titles return multiple possible recordings instead of selecting one without evidence.

Each answer is available as readable text and MCP `structuredContent`. Successful results include resolution status, ranked merchants, URLs, prices when known, source warnings, and a `resolved_at` timestamp. A missing match is returned as `no_results` with `did_you_mean` suggestions; it is not treated as a transport error. The server states when source coverage is partial or an artist’s discography is not yet indexed.

`find_product` detects the category from the request and routes it to the appropriate resolver. Music is active today. The registered game resolver is not active and returns a coming-soon response without links or prices.

## Setup and configuration

The rootvine-mcp MCP server can be used remotely at `https://mcp.rootvine.ai/mcp` with a client that accepts remote MCP servers. The hosted endpoint requires no login or API key. It can also run locally with npm:

```bash
npx rootvine-mcp
```

For Claude Desktop, add an MCP server entry that runs `npx` with `-y rootvine-mcp`, then restart the application. Other MCP-compatible clients can use the same stdio command. The local npm package does not send the hosted endpoint’s anonymous caller identifier. The hosted service logs which tool was called, but not the caller’s address or request text.

## Tools and capabilities

- `resolve_music` finds streaming, digital-purchase, vinyl, CD, and Discogs options for a song or album.
- `resolve_artist` returns artist metadata and the releases held in BeatsVine’s catalogue.
- `discover_music` browses chambers, walls, charts, moods, spotlights, and historical collections. A `resolve` option can fetch links for a chart’s named entry.
- `find_product` routes a request to the relevant resolver based on category words.

The deprecated `slug` input can be used instead of `query`, but callers should send only one of them. Discovery supports chamber, wall, year, limit, and resolve parameters. Historical archive coverage includes complete US Billboard Year-End Hot 100 charts from 1946 onward; UK year-end collections expose the number one entry and link to the full chart source.

The service excludes commission rates, affiliate networks, and sponsored flags from ranking. Result links may still include affiliate-tagged click-through URLs for tracking. Game resolution, along with books, films, podcasts, and live events, is not active in the current material.

_Full upstream README: https://allmcps.com/mcp/rootvine-mcp/readme_