Server definition
- Hash
- sha256:9b55937b41d3df4b487795623416f1bb804a9816c7dd36ffdfd6a81d8f95a73c
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": "Boxlist (www.boxlist.com) scores every film, TV series, book and video game on the same ten taste dimensions, so it can explain why a title suits someone and match across media. Start with search_titles when a name is ambiguous; pass the returned `ref` to the other tools. get_title_taste_profile explains how a title feels (and where to watch it in the UK/US). find_similar_in_feel finds titles that feel alike, across media. quick_taste_read turns 2-5 loved titles into a Taste Fingerprint™ reading with suggestions. match_for_two finds titles two people will both enjoy. Each call returns at most 5 titles. When you use these results: credit them as \"Data from Boxlist\" with a link, show the boxlist.com link for each title you mention (keep the links exactly as given), and you may offer the reply's one `nextStep` link to the user. Write the name as \"Taste Fingerprint™\". All tools are read-only and anonymous. Terms of use: Credit Boxlist: show \"Data from Boxlist\" with a link to www.boxlist.com, and keep the boxlist.com link next to each title. No bulk copying of Boxlist data and no resale. Full terms: https://mcp.boxlist.com/terms. Privacy policy: https://www.boxlist.com/privacy. Docs: https://www.boxlist.com/ai-assistants",
"tools": [
{
"description": "Titles that feel like a given film, TV series, book or game — matched on Boxlist's taste dimensions, story themes and subjects, not just genre or cast — across all four media or only the ones you choose. Each result says what it shares with the starting title. Good for \"I loved X, what next?\" and cross-media asks like \"a book that feels like Succession\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 5,
"description": "How many titles (1-5, default 5).",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"media": {
"description": "Media to suggest from. Omit for all four (films, TV, books, games). Use [\"book\"] for \"what should I read next\".",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"title": {
"description": "The title to start from: a name, a boxlist.com URL, or a `ref` from another Boxlist tool.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"titleMedia": {
"description": "Medium of the starting title, when the name is shared (e.g. \"book\" for Dune the novel).",
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "find_similar_in_feel",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"additionalProperties": false,
"description": "Required credit: show \"Data from Boxlist\" with the link wherever these results are used.",
"properties": {
"terms": {
"type": "string"
},
"text": {
"const": "Data from Boxlist",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url",
"terms"
],
"type": "object"
},
"didYouMean": {
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"matchedBy": {
"type": "string"
},
"method": {
"description": "\"site\" = the exact \"Similar in feel\" list shown on boxlist.com; \"model\" = the same model run live (cross-media).",
"enum": [
"site",
"model"
],
"type": "string"
},
"nextStep": {
"anyOf": [
{
"additionalProperties": false,
"description": "One follow-up link worth offering the user (show it as a single line).",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"note": {
"description": "Present when Boxlist has little story data for the starting title, so matches are looser.",
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"closeness": {
"enum": [
"very close",
"close",
"related"
],
"type": "string"
},
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"why": {
"description": "What it shares with the starting title, in plain words.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image",
"closeness",
"why"
],
"type": "object"
},
"type": "array"
},
"seed": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
}
},
"required": [
"seed",
"matchedBy",
"didYouMean",
"results",
"method",
"nextStep",
"attribution"
],
"type": "object"
}
},
{
"description": "How a film, TV series, book or video game feels, in plain words: its scores on Boxlist's ten taste dimensions (pace, originality, wholesomeness, weightiness, realism, intricacy, linearity, style, scale, emotional punch), its story themes and the Taste Type it suits. For films and TV it adds where to watch in the UK and US; for games, platforms and stores. Use it to explain why someone might or might not enjoy a title.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"media": {
"description": "Which medium you mean, when the name is shared (e.g. \"book\" for Dune the novel).",
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"title": {
"description": "A title name (\"Succession\", \"Dune (2021)\"), a boxlist.com URL, or a `ref` from another Boxlist tool.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"year": {
"description": "Release year, to tell remakes apart.",
"maximum": 2100,
"minimum": 1870,
"type": "integer"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "get_title_taste_profile",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"additionalProperties": false,
"description": "Required credit: show \"Data from Boxlist\" with the link wherever these results are used.",
"properties": {
"terms": {
"type": "string"
},
"text": {
"const": "Data from Boxlist",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url",
"terms"
],
"type": "object"
},
"dataFreshness": {
"enum": [
"live",
"snapshot"
],
"type": "string"
},
"didYouMean": {
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"dimensions": {
"items": {
"additionalProperties": false,
"properties": {
"dimension": {
"type": "string"
},
"lean": {
"enum": [
"low",
"high",
"balanced"
],
"type": "string"
},
"name": {
"type": "string"
},
"percent": {
"type": "number"
},
"poles": {
"additionalProperties": false,
"properties": {
"high": {
"type": "string"
},
"low": {
"type": "string"
}
},
"required": [
"low",
"high"
],
"type": "object"
},
"reading": {
"description": "Plain words, e.g. \"Very slow\".",
"type": "string"
},
"score": {
"description": "0.5 (low pole) to 5.5 (high pole); 3 is the middle.",
"type": "number"
},
"strength": {
"enum": [
"balanced",
"slightly",
"fairly",
"very"
],
"type": "string"
}
},
"required": [
"dimension",
"name",
"score",
"percent",
"poles",
"lean",
"strength",
"reading"
],
"type": "object"
},
"type": "array"
},
"genres": {
"items": {
"type": "string"
},
"type": "array"
},
"matchedBy": {
"type": "string"
},
"nextStep": {
"anyOf": [
{
"additionalProperties": false,
"description": "One follow-up link worth offering the user (show it as a single line).",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"storyThemes": {
"items": {
"type": "string"
},
"type": "array"
},
"subjects": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"description": "One or two plain sentences on how the title feels.",
"type": "string"
},
"tasteType": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"blurb": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"blurb",
"url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Which of the four Boxlist Taste Types this title most suits."
},
"title": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"whereToPlay": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"platforms": {
"items": {
"type": "string"
},
"type": "array"
},
"stores": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"platforms",
"stores"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Games only."
},
"whereToWatch": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"uk": {
"items": {
"additionalProperties": false,
"properties": {
"buyFrom": {
"type": [
"string",
"null"
]
},
"link": {
"type": [
"string",
"null"
]
},
"offers": {
"description": "stream = included with a subscription.",
"items": {
"enum": [
"stream",
"free",
"ads",
"rent",
"buy"
],
"type": "string"
},
"type": "array"
},
"rentFrom": {
"type": [
"string",
"null"
]
},
"seasons": {
"description": "TV: seasons this offer covers, when known.",
"items": {
"type": "string"
},
"type": "array"
},
"service": {
"type": "string"
}
},
"required": [
"service",
"offers",
"rentFrom",
"buyFrom",
"seasons",
"link"
],
"type": "object"
},
"type": "array"
},
"us": {
"items": {
"additionalProperties": false,
"properties": {
"buyFrom": {
"type": [
"string",
"null"
]
},
"link": {
"type": [
"string",
"null"
]
},
"offers": {
"description": "stream = included with a subscription.",
"items": {
"enum": [
"stream",
"free",
"ads",
"rent",
"buy"
],
"type": "string"
},
"type": "array"
},
"rentFrom": {
"type": [
"string",
"null"
]
},
"seasons": {
"description": "TV: seasons this offer covers, when known.",
"items": {
"type": "string"
},
"type": "array"
},
"service": {
"type": "string"
}
},
"required": [
"service",
"offers",
"rentFrom",
"buyFrom",
"seasons",
"link"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"uk",
"us",
"note"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Films and TV only: UK and US services."
}
},
"required": [
"title",
"matchedBy",
"didYouMean",
"summary",
"dimensions",
"tasteType",
"storyThemes",
"subjects",
"genres",
"whereToWatch",
"whereToPlay",
"dataFreshness",
"nextStep",
"attribution"
],
"type": "object"
}
},
{
"description": "Find titles two people will both enjoy, from one to five titles each of them loves. Blends their two Taste Fingerprint™ profiles the way Boxlist's Watch together does, skips anything either is likely to dislike, and returns picks with a band for the pair and for each person, plus where their tastes agree and differ. Defaults to films and TV; books and games can be added. Anonymous, nothing stored.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 5,
"description": "How many picks (1-5, default 5).",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"media": {
"description": "Same as suggestFrom (either name works).",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"personA": {
"additionalProperties": false,
"properties": {
"lovedTitles": {
"description": "1 to 5 titles this person loves: names, boxlist.com URLs or refs. More titles give a better read.",
"items": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"name": {
"description": "First name or label used in the answer (default \"Person A\"/\"Person B\"). Not stored.",
"maxLength": 40,
"minLength": 1,
"type": "string"
}
},
"required": [
"lovedTitles"
],
"type": "object"
},
"personB": {
"additionalProperties": false,
"properties": {
"lovedTitles": {
"description": "1 to 5 titles this person loves: names, boxlist.com URLs or refs. More titles give a better read.",
"items": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"name": {
"description": "First name or label used in the answer (default \"Person A\"/\"Person B\"). Not stored.",
"maxLength": 40,
"minLength": 1,
"type": "string"
}
},
"required": [
"lovedTitles"
],
"type": "object"
},
"suggestFrom": {
"description": "Media to pick from. Omit for films and TV (watching together); add \"book\" or \"game\" if wanted.",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
}
},
"required": [
"personA",
"personB"
],
"type": "object"
},
"name": "match_for_two",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"additionalProperties": false,
"description": "Required credit: show \"Data from Boxlist\" with the link wherever these results are used.",
"properties": {
"terms": {
"type": "string"
},
"text": {
"const": "Data from Boxlist",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url",
"terms"
],
"type": "object"
},
"commonGround": {
"description": "Where the two tastes agree and where they pull apart.",
"type": "string"
},
"nextStep": {
"anyOf": [
{
"additionalProperties": false,
"description": "One follow-up link worth offering the user (show it as a single line).",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"personA": {
"additionalProperties": false,
"properties": {
"leans": {
"description": "Their strongest leans in plain words.",
"type": "string"
},
"name": {
"type": "string"
},
"tasteType": {
"type": "string"
},
"tasteTypeStreak": {
"description": "The near-tie second Taste Type as a phrase, e.g. \"with a Reality Biter streak\": present when it scores within 5 points of the top type.",
"type": "string"
},
"understood": {
"items": {
"additionalProperties": false,
"properties": {
"didYouMean": {
"description": "Other titles with similar names; ask the user if the match looks wrong.",
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"found": {
"type": "boolean"
},
"input": {
"type": "string"
},
"matchedBy": {
"anyOf": [
{
"enum": [
"ref",
"exact",
"close",
"live"
],
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"found",
"title",
"matchedBy",
"didYouMean"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"understood",
"tasteType",
"leans"
],
"type": "object"
},
"personB": {
"additionalProperties": false,
"properties": {
"leans": {
"description": "Their strongest leans in plain words.",
"type": "string"
},
"name": {
"type": "string"
},
"tasteType": {
"type": "string"
},
"tasteTypeStreak": {
"description": "The near-tie second Taste Type as a phrase, e.g. \"with a Reality Biter streak\": present when it scores within 5 points of the top type.",
"type": "string"
},
"understood": {
"items": {
"additionalProperties": false,
"properties": {
"didYouMean": {
"description": "Other titles with similar names; ask the user if the match looks wrong.",
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"found": {
"type": "boolean"
},
"input": {
"type": "string"
},
"matchedBy": {
"anyOf": [
{
"enum": [
"ref",
"exact",
"close",
"live"
],
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"found",
"title",
"matchedBy",
"didYouMean"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"understood",
"tasteType",
"leans"
],
"type": "object"
},
"picks": {
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"forA": {
"type": "string"
},
"forB": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"together": {
"description": "Match band for the two together.",
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"why": {
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image",
"together",
"forA",
"forB",
"why"
],
"type": "object"
},
"type": "array"
},
"privacy": {
"type": "string"
}
},
"required": [
"personA",
"personB",
"commonGround",
"picks",
"privacy",
"nextStep",
"attribution"
],
"type": "object"
}
},
{
"description": "Turn 2 to 5 titles someone loves (films, TV, books or games, mixed is fine) into a short Taste Fingerprint™ reading — their leans on Boxlist's taste dimensions, their Taste Type and recurring themes — plus suggestions with a Boxlist match band and a reason for each. Anonymous: no account, nothing stored. Use it for \"what should I watch/read/play, I like X, Y and Z\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 5,
"description": "How many suggestions (1-5, default 5).",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"lovedTitles": {
"description": "2 to 5 films, shows, books or games the person loves (3 or more give a better read): names (\"Succession\", \"Dune (2021)\"), boxlist.com URLs or refs.",
"items": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
},
"media": {
"description": "Same as suggestFrom (either name works).",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"suggestFrom": {
"description": "Media to suggest from. Omit for all four (leaning towards the medium of the loved titles).",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
}
},
"required": [
"lovedTitles"
],
"type": "object"
},
"name": "quick_taste_read",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"additionalProperties": false,
"description": "Required credit: show \"Data from Boxlist\" with the link wherever these results are used.",
"properties": {
"terms": {
"type": "string"
},
"text": {
"const": "Data from Boxlist",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url",
"terms"
],
"type": "object"
},
"nextStep": {
"anyOf": [
{
"additionalProperties": false,
"description": "One follow-up link worth offering the user (show it as a single line).",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"privacy": {
"type": "string"
},
"suggestions": {
"items": {
"additionalProperties": false,
"properties": {
"band": {
"description": "Boxlist match band: Perfect match, Strong match, Mixed, Weak match or Not for you.",
"type": "string"
},
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"tier": {
"description": "1 = Perfect match ... 5 = Not for you.",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"why": {
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image",
"band",
"tier",
"why"
],
"type": "object"
},
"type": "array"
},
"tasteFingerprint": {
"additionalProperties": false,
"properties": {
"alsoClose": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"blurb": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"blurb",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"leans": {
"items": {
"additionalProperties": false,
"properties": {
"dimension": {
"type": "string"
},
"lean": {
"description": "Pole label the person leans to, e.g. \"Slow\".",
"type": "string"
},
"name": {
"type": "string"
},
"reading": {
"description": "Plain words, e.g. \"Clear lean to Slow\".",
"type": "string"
},
"strength": {
"enum": [
"slight",
"clear",
"strong"
],
"type": "string"
},
"value": {
"description": "0.5 (low pole) to 5.5 (high pole); 3 is neutral.",
"type": "number"
}
},
"required": [
"dimension",
"name",
"value",
"lean",
"strength",
"reading"
],
"type": "object"
},
"type": "array"
},
"likedSubjects": {
"items": {
"type": "string"
},
"type": "array"
},
"likedThemes": {
"items": {
"type": "string"
},
"type": "array"
},
"streak": {
"description": "The near-tie second Taste Type as a phrase, e.g. \"with a Reality Biter streak\": present when it scores within 5 points of the top type.",
"type": "string"
},
"summary": {
"type": "string"
},
"tasteType": {
"additionalProperties": false,
"properties": {
"blurb": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"blurb",
"url"
],
"type": "object"
}
},
"required": [
"summary",
"tasteType",
"alsoClose",
"leans",
"likedThemes",
"likedSubjects"
],
"type": "object"
},
"understood": {
"items": {
"additionalProperties": false,
"properties": {
"didYouMean": {
"description": "Other titles with similar names; ask the user if the match looks wrong.",
"items": {
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
"type": "array"
},
"found": {
"type": "boolean"
},
"input": {
"type": "string"
},
"matchedBy": {
"anyOf": [
{
"enum": [
"ref",
"exact",
"close",
"live"
],
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"found",
"title",
"matchedBy",
"didYouMean"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"understood",
"tasteFingerprint",
"suggestions",
"privacy",
"nextStep",
"attribution"
],
"type": "object"
}
},
{
"description": "Find films, TV series, books and video games in the Boxlist catalogue by name (books also by author). Returns each title's boxlist.com page and a `ref` to pass to the other Boxlist tools. Use it to pin down the right title (e.g. which \"Dune\") before asking for a taste profile or similar titles.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"default": 5,
"description": "How many results (1-5, default 5).",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"media": {
"description": "Restrict to these media: \"film\", \"tv\", \"book\", \"game\". Omit for all four.",
"items": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"query": {
"description": "Title or part of it, optionally with a year (\"Dune 2021\"). Books also match by author.",
"maxLength": 100,
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_titles",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attribution": {
"additionalProperties": false,
"description": "Required credit: show \"Data from Boxlist\" with the link wherever these results are used.",
"properties": {
"terms": {
"type": "string"
},
"text": {
"const": "Data from Boxlist",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url",
"terms"
],
"type": "object"
},
"nextStep": {
"anyOf": [
{
"additionalProperties": false,
"description": "One follow-up link worth offering the user (show it as a single line).",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"blurb": {
"description": "Short description when available (books and games).",
"type": [
"string",
"null"
]
},
"creator": {
"description": "Author for books, developer for games.",
"type": [
"string",
"null"
]
},
"image": {
"type": [
"string",
"null"
]
},
"match": {
"description": "How well the name matched the query.",
"enum": [
"exact",
"starts with",
"partial"
],
"type": "string"
},
"media": {
"enum": [
"film",
"tv",
"book",
"game"
],
"type": "string"
},
"mediaLabel": {
"type": "string"
},
"ref": {
"description": "Stable reference; pass it back to other Boxlist tools as `title` (e.g. \"tv/Succession-2018\").",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Canonical boxlist.com page. Always show or link this.",
"type": "string"
},
"year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"ref",
"media",
"mediaLabel",
"title",
"year",
"creator",
"url",
"image",
"match",
"blurb"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"query",
"results",
"note",
"nextStep",
"attribution"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:9b55937b41d3df4b487795623416f1bb804a9816c7dd36ffdfd6a81d8f95a73c | sha256sum