rootvine-mcp

Find a product

find_product

Read-only

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes	The user's words: 'where can I stream Bad Guy by Billie Eilish', 'Mario Kart on Switch'.
`category`	No	Set it when you know it; 'auto' (the default) reads it from the words.

Output Schema

TableJSON Schema

Name	Required	Description
`game`	No
`music`	No
`category`	Yes
`detected`	Yes	true: the category was read from the words — set `category` if it is wrong

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 26, 2026

changedInput schema / properties / category / description

Previous value: -"Product category. Use 'auto' (default) to let RootVine detect the category automatically."New value: +"Set it when you know it; 'auto' (the default) reads it from the words."

changedInput schema / properties / query / description

Previous value: -"A natural language product query. Examples: 'Aphex Twin Windowlicker', 'Elden Ring DLC', 'where can I stream Bad Guy by Billie Eilish'"New value: +"The user's words: 'where can I stream Bad Guy by Billie Eilish', 'Mario Kart on Switch'."

addedInput schema / properties / query / maxLength
```
Added value: +500
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "category": {
+      "enum": [
+        "music",
+        "game"
+      ],
+      "type": "string"
+    },
+    "detected": {
+      "description": "true: the category was read from the words — set `category` if it is wrong",
+      "type": "boolean"
+    },
+    "game": {
+      "additionalProperties": {},
+      "properties": {
+        "live": {
+          "description": "false: games are not live yet — there are no links or prices to give",
+          "type": "boolean"
+        },
+        "message": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "query": {
+          "type": "string"
+        },
+        "resolved_at": {
+          "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": [
+            "coming_soon",
+            "success",
+            "partial",
+            "no_results"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "status",
+        "live",
+        "query",
+        "message",
+        "results",
+        "response_id",
+        "resolved_at"
+      ],
+      "type": "object"
+    },
+    "music": {
+      "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"
+    }
+  },
+  "required": [
+    "category",
+    "detected"
+  ],
+  "type": "object"
+}

First observedSep 26, 2026

TDQS

A4.6/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 readOnly/openWorld annotations: 'RootVine never fabricates', 'Every link existed at resolved_at', and specific handling instructions for partial and no_results responses. It also discloses that games are not live yet and that results are UK/GBP-focused. No contradiction with annotations.

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

Conciseness4/5

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

The description is information-dense and front-loaded with the key routing guidance. It earns most sentences, but the games-not-live limitation is stated twice ('games answer coming soon' and 'music only today — games are not live yet'), which is minor padding.

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?

For a two-parameter tool with an output schema and readOnly/openWorld annotations, the description covers routing behavior, parameter usage, current limitations, geographic scope, and failure-mode handling. Nothing essential for correct selection and invocation is missing.

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?

Schema coverage is 100%, so the baseline is 3. The description adds meaningful usage meaning: `query` should be the user's raw words used for keyword-based detection, and `category` should be set when known or left to the 'auto' default. This goes beyond the schema's field descriptions.

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 opens with 'Start here when the category is unclear' and clearly explains that it takes the user's words, detects music or games, and answers in that tool's shape. This distinguishes it from the sibling resolve_* and discover_music tools by establishing it as the routing/entry-point tool.

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?

It explicitly states when to use it ('Start here when the category is unclear') and advises setting `category` when known. It also gives useful behavioral guidance for partial/no_results cases. However, it doesn't name explicit alternatives or say what to do when the category is already clear, so there are no direct when-not/alternative exclusions.

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.