Server definition
- Hash
- sha256:440c823ef30a097b6d1376363faa634687ad5364c77986b03a56b4f4c3450ee8
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"chamber": {
"description": "Chamber to browse; omit for an overview of all chambers and featured walls. 'by-genre' = genre corridors. 'for-this-moment' = moods and activities. 'charts' = live streaming charts. 'by-era' = decades. 'spotlights' = artist features.",
"enum": [
"by-genre",
"for-this-moment",
"charts",
"by-era",
"spotlights"
],
"type": "string"
},
"limit": {
"description": "Max walls, entries or snapshots to return: 10 by default, 30 at most.",
"exclusiveMinimum": 0,
"maximum": 30,
"type": "integer"
},
"resolve": {
"description": "With `wall`: also fetch number one's stream and buy links, in the same call.",
"type": "boolean"
},
"wall": {
"description": "A wall or chart-snapshot slug from an earlier answer (a BeatsVine wall address also works). Lists its entries; on a ranked chart position 1 is number one. Takes priority over `chamber` and `year`.",
"maxLength": 500,
"type": "string"
},
"year": {
"description": "Chart snapshots from this year (1946 to now), for questions about the past — 'number one in 1994'. Pass a snapshot's slug back as `wall` for its entries. Takes priority over `chamber`.",
"maximum": 2100,
"minimum": 1946,
"type": "integer"
}
},
"type": "object"
},
"name": "discover_music",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"chamber": {
"additionalProperties": {},
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tagline": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"name",
"tagline"
],
"type": "object"
},
"chambers": {
"items": {
"additionalProperties": {},
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"tagline": {
"type": [
"string",
"null"
]
},
"wall_count": {
"type": "number"
}
},
"required": [
"slug",
"name",
"tagline",
"wall_count"
],
"type": "object"
},
"type": "array"
},
"entries": {
"items": {
"additionalProperties": {},
"properties": {
"artist": {
"type": [
"string",
"null"
]
},
"cover_url": {
"type": [
"string",
"null"
]
},
"kind": {
"anyOf": [
{
"enum": [
"track",
"album",
"artist"
],
"type": "string"
},
{
"type": "null"
}
]
},
"page_url": {
"type": [
"string",
"null"
]
},
"position": {
"type": "number"
},
"preview_url": {
"type": [
"string",
"null"
]
},
"query": {
"description": "Pass to resolve_music (resolve_artist for an artist) for links; null: no BeatsVine page yet",
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"position",
"title",
"artist",
"kind",
"query",
"page_url",
"cover_url",
"preview_url"
],
"type": "object"
},
"type": "array"
},
"mode": {
"enum": [
"foyer",
"chamber",
"wall",
"archives"
],
"type": "string"
},
"resolved_at": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": {},
"properties": {
"entry_count": {
"type": "number"
},
"name": {
"type": "string"
},
"page_url": {
"type": "string"
},
"publication": {
"anyOf": [
{
"additionalProperties": {},
"description": "How much of the chart BeatsVine shows: 'full'; 'headline' — the number one only, the rest at full_chart_url; 'yearly-number-ones' — each year's best seller, no overall number one",
"properties": {
"chart_owner": {
"type": [
"string",
"null"
]
},
"full_chart_url": {
"type": [
"string",
"null"
]
},
"mode": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
}
},
"required": [
"mode",
"chart_owner",
"full_chart_url",
"note"
],
"type": "object"
},
{
"type": "null"
}
]
},
"slug": {
"description": "Pass as `wall`, with resolve: true for number one's links",
"type": "string"
},
"week": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"name",
"week",
"entry_count",
"page_url",
"publication"
],
"type": "object"
},
"type": "array"
},
"source_url": {
"type": [
"string",
"null"
]
},
"top": {
"anyOf": [
{
"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"
},
{
"type": "null"
}
],
"description": "Number one's links, when resolve was asked for"
},
"top_note": {
"type": [
"string",
"null"
]
},
"total": {
"type": [
"number",
"null"
]
},
"wall": {
"additionalProperties": {},
"properties": {
"attribution": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"entity_type": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"page_url": {
"type": "string"
},
"publication": {
"anyOf": [
{
"additionalProperties": {},
"description": "How much of the chart BeatsVine shows: 'full'; 'headline' — the number one only, the rest at full_chart_url; 'yearly-number-ones' — each year's best seller, no overall number one",
"properties": {
"chart_owner": {
"type": [
"string",
"null"
]
},
"full_chart_url": {
"type": [
"string",
"null"
]
},
"mode": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
}
},
"required": [
"mode",
"chart_owner",
"full_chart_url",
"note"
],
"type": "object"
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"name",
"description",
"entity_type",
"attribution",
"page_url",
"publication"
],
"type": "object"
},
"walls": {
"items": {
"additionalProperties": {},
"properties": {
"attribution": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"entry_count": {
"type": "number"
},
"name": {
"type": "string"
},
"page_url": {
"type": "string"
},
"slug": {
"description": "Pass as `wall` to list its entries",
"type": "string"
}
},
"required": [
"slug",
"name",
"description",
"entry_count",
"attribution",
"page_url"
],
"type": "object"
},
"type": "array"
},
"year": {
"type": [
"number",
"null"
]
},
"years": {
"items": {
"type": "number"
},
"type": "array"
}
},
"required": [
"mode",
"source_url",
"resolved_at",
"total"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"category": {
"description": "Set it when you know it; 'auto' (the default) reads it from the words.",
"enum": [
"music",
"game",
"auto"
],
"type": "string"
},
"query": {
"description": "The user's words: 'where can I stream Bad Guy by Billie Eilish', 'Mario Kart on Switch'.",
"maxLength": 500,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "find_product",
"outputSchema": {
"$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"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"description": "The artist's name in plain words: 'Stromae', 'Billie Eilish'. Also takes a BeatsVine artist address or an `artist/…` query from an earlier answer.",
"maxLength": 500,
"type": "string"
},
"slug": {
"description": "Deprecated alias for `query`, kept for older clients. Send exactly one of `query` or `slug`.",
"maxLength": 500,
"type": "string"
}
},
"type": "object"
},
"name": "resolve_artist",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"artist": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"genres": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"page_url": {
"type": "string"
},
"query": {
"description": "Pass back to resolve_artist to open this artist",
"type": "string"
}
},
"required": [
"name",
"query",
"page_url",
"genres"
],
"type": "object"
},
{
"type": "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"
},
"discography_complete": {
"description": "false: BeatsVine has not indexed this artist yet — an empty list means unknown, not none",
"type": [
"boolean",
"null"
]
},
"release_count": {
"type": [
"number",
"null"
]
},
"releases": {
"items": {
"additionalProperties": {},
"properties": {
"cover_url": {
"type": [
"string",
"null"
]
},
"page_url": {
"type": [
"string",
"null"
]
},
"query": {
"description": "Pass to resolve_music for this release's links",
"type": "string"
},
"title": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"title",
"type",
"year",
"query",
"page_url",
"cover_url"
],
"type": "object"
},
"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": {
"type": "string"
},
"status": {
"enum": [
"success",
"no_results"
],
"type": "string"
}
},
"required": [
"status",
"artist",
"discography_complete",
"release_count",
"releases",
"resolved_as",
"did_you_mean",
"resolved_at"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"description": "The game's name in plain words: 'Elden Ring'.",
"maxLength": 500,
"type": "string"
},
"slug": {
"description": "Deprecated alias for `query`, kept for older clients. Send exactly one of `query` or `slug`.",
"maxLength": 500,
"type": "string"
}
},
"type": "object"
},
"name": "resolve_game",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"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"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"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"
},
"slug": {
"description": "Deprecated alias for `query`, kept for older clients. Send exactly one of `query` or `slug`.",
"maxLength": 500,
"type": "string"
}
},
"type": "object"
},
"name": "resolve_music",
"outputSchema": {
"$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"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:440c823ef30a097b6d1376363faa634687ad5364c77986b03a56b4f4c3450ee8 | sha256sum