rootvine-mcp

Music links

resolve_music

Read-only

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`slug`	No	Deprecated alias for `query`, kept for older clients. Send exactly one of `query` or `slug`.
`query`	No	What to look up, in the user's own words: 'galway girl by ed sheeran', 'Abbey Road vinyl'. Also takes a BeatsVine page address or a `query` value from an earlier answer. Do not build slugs.

Output Schema

TableJSON Schema

Name	Required	Description
`kind`	Yes
`title`	Yes
`artist`	Yes
`status`	Yes
`results`	Yes
`page_url`	Yes	The BeatsVine page, only when it is confirmed to exist
`warnings`	Yes
`cover_art`	Yes
`resolved_as`	Yes
`resolved_at`	Yes	Every link existed at this time
`response_id`	Yes
`ttl_seconds`	Yes
`did_you_mean`	Yes
`partial_sources`	Yes	Sources that did not answer: say so when not empty

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedSep 26, 2026

addedInput schema / properties / query

Added value: +{
+  "description": "What to look up, in the user's own words: 'galway girl by ed sheeran', 'Abbey Road vinyl'. Also takes a BeatsVine page address or a `query` value from an earlier answer. Do not build slugs.",
+  "maxLength": 500,
+  "type": "string"
+}

changedInput schema / properties / slug / description

Previous value: -"The BeatsVine page slug for the track or album. Format: artist-name-song-title, lowercase and hyphenated. Slugs keep letters of any script, so non-Latin titles are valid: 'ed-sheeran-galway-girl', 'ヨルシカ-火星人'. Latin accents are folded to their base letter ('Rosalía Despechá' → 'rosalia-despecha'), and punctuation is dropped. Pass the slug undecoded — do not percent-encode it yourself."New value: +"Deprecated alias for `query`, kept for older clients. Send exactly one of `query` or `slug`."

addedInput schema / properties / slug / maxLength
```
Added value: +500
```
removedInput schema / required
```
Removed value: -[
-  "slug"
-]
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "artist": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "cover_art": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "did_you_mean": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "artist": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "kind": {
+            "enum": [
+              "track",
+              "album",
+              "artist"
+            ],
+            "type": "string"
+          },
+          "page_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "query": {
+            "description": "Pass back as `query` to open exactly this",
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "artist",
+          "kind",
+          "query",
+          "page_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "kind": {
+      "anyOf": [
+        {
+          "enum": [
+            "track",
+            "album"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "page_url": {
+      "description": "The BeatsVine page, only when it is confirmed to exist",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "partial_sources": {
+      "description": "Sources that did not answer: say so when not empty",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "resolved_as": {
+      "additionalProperties": {},
+      "properties": {
+        "corrected": {
+          "description": "The answer is for different words than asked: tell the user what is shown",
+          "type": "boolean"
+        },
+        "note": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "query": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "via": {
+          "anyOf": [
+            {
+              "enum": [
+                "direct",
+                "catalogue_search",
+                "live_lookup"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "query",
+        "via",
+        "corrected",
+        "note"
+      ],
+      "type": "object"
+    },
+    "resolved_at": {
+      "description": "Every link existed at this time",
+      "type": "string"
+    },
+    "response_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "results": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "availability": {
+            "enum": [
+              "in_stock",
+              "preorder",
+              "available",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "click_url": {
+            "description": "The link to give the user",
+            "type": "string"
+          },
+          "edition": {
+            "type": "string"
+          },
+          "merchant": {
+            "type": "string"
+          },
+          "merchant_id": {
+            "type": "string"
+          },
+          "price": {
+            "anyOf": [
+              {
+                "additionalProperties": {},
+                "properties": {
+                  "amount": {
+                    "type": "number"
+                  },
+                  "currency": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "amount",
+                  "currency"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "null when no price is listed — never zero, never free"
+          },
+          "price_freshness": {
+            "type": "string"
+          },
+          "rank": {
+            "type": "number"
+          },
+          "ranking_reason": {
+            "additionalProperties": {},
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "summary": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "code",
+              "summary"
+            ],
+            "type": "object"
+          },
+          "trust_tier": {
+            "enum": [
+              "authoritative",
+              "verified",
+              "listed"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "purchase",
+              "stream",
+              "subscription"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "rank",
+          "merchant",
+          "merchant_id",
+          "type",
+          "trust_tier",
+          "availability",
+          "price",
+          "click_url",
+          "url",
+          "ranking_reason"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "status": {
+      "enum": [
+        "success",
+        "partial",
+        "no_results"
+      ],
+      "type": "string"
+    },
+    "title": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "ttl_seconds": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "warnings": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "status",
+    "artist",
+    "title",
+    "kind",
+    "results",
+    "partial_sources",
+    "warnings",
+    "resolved_as",
+    "did_you_mean",
+    "page_url",
+    "cover_art",
+    "response_id",
+    "resolved_at",
+    "ttl_seconds"
+  ],
+  "type": "object"
+}

First observedSep 26, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds substantial behavioral context beyond the readOnlyHint and openWorldHint annotations: links existed at resolved_at, RootVine never fabricates, rankings ignore commissions, results are UK-focused with GBP prices, and edge cases like partial/no_results have explicit handling. Nothing contradicts the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but every sentence earns its place, covering purpose, usage, reliability, limits, and failure behavior. It is front-loaded with the core purpose before diving into details, and it avoids filler or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity and the existence of an output schema, the description still provides complete operational context: how to call it, what to do with did_you_mean and corrected results, limits, and how to surface failures. An agent can correctly invoke and interpret the response without additional information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema coverage is 100%, so the baseline is 3. The description adds meaning beyond the schema by showing natural-language examples, allowing a BeatsVine page address or a prior query value, and repeatedly instructing 'never build slugs.' This is useful but not dramatically beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description defines the tool's core job with a specific verb and resource: resolving a song or album into live stream/buy/collect links across services and formats. It further distinguishes itself from siblings by scoping to 'music only today — games are not live yet' and to 'a song or album,' separating it from resolve_artist and resolve_game.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives strong when-to-use guidance: 'Call it rather than recall: links and prices change; a guessed link 404s.' It also provides behavioral instructions for miss, corrected, partial, and no-results cases. However, it does not explicitly mention alternatives like discover_music or resolve_artist, though the 'song or album' and 'music only' scope implicitly excludes them.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All rootvine-mcp tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.