The Curator

Show Curator finds

render_curator_items

Read-onlyIdempotent

Display up to 12 Curator finds as interactive cards in chat. First call search_curator or get_curator_item and choose matching IDs. Pass only those IDs; the server supplies authoritative public facts. Preserves the requested order. Users can filter, inspect, select and discuss items; selections are temporary and are not a saved wishlist.

Input Schema

Name	Required	Description	Default
`ids`	Yes

Output Schema

Name	Required	Description	Default
`error`	No
`items`	Yes
`total`	Yes
`offset`	Yes
`hasMore`	Yes
`categories`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 2, 2026

addedOutput schema / properties / error

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "code": {
+      "const": "not_found",
+      "type": "string"
+    },
+    "message": {
+      "maxLength": 300,
+      "type": "string"
+    },
+    "retryable": {
+      "const": false,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "code",
+    "message",
+    "retryable"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 31, 2026

changedOutput schema / properties / items / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "attribution": {
-        "type": "string"
-      },
-      "category": {
-        "type": "string"
-      },
-      "description": {
-        "type": "string"
-      },
-      "details": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string"
-            },
-            "value": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "value"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-        "type": "string"
-      },
-      "images": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "alt": {
-              "type": "string"
-            },
-            "url": {
-              "pattern": "^https:\\/\\/",
-              "type": "string"
-            }
-          },
-          "required": [
-            "url",
-            "alt"
-          ],
-          "type": "object"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "media": {
-        "additionalProperties": false,
-        "properties": {
-          "artworkPurchase": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "badgeUrl": {
-                    "pattern": "^https:\\/\\/",
-                    "type": "string"
-                  },
-                  "label": {
-                    "type": "string"
-                  },
-                  "url": {
-                    "pattern": "^https:\\/\\/",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "url",
-                  "badgeUrl",
-                  "label"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "background": {
-            "anyOf": [
-              {
-                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "caption": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "credit": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "disclosure": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "caption",
-          "disclosure",
-          "credit",
-          "background",
-          "artworkPurchase"
-        ],
-        "type": "object"
-      },
-      "merchant": {
-        "additionalProperties": false,
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "outboundUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          },
-          "productUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          }
-        },
-        "required": [
-          "name",
-          "productUrl",
-          "outboundUrl"
-        ],
-        "type": "object"
-      },
-      "music": {
-        "additionalProperties": false,
-        "properties": {
-          "artist": {
-            "type": "string"
-          },
-          "displayedDuration": {
-            "type": "string"
-          },
-          "embedUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          },
-          "kind": {
-            "enum": [
-              "album",
-              "track"
-            ],
-            "type": "string"
-          },
-          "releaseDate": {
-            "anyOf": [
-              {
-                "format": "date",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "trackCount": {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "artist",
-          "releaseDate",
-          "trackCount",
-          "displayedDuration",
-          "embedUrl"
-        ],
-        "type": "object"
-      },
-      "name": {
-        "type": "string"
-      },
-      "number": {
-        "pattern": "^[0-9]+$",
-        "type": "string"
-      },
-      "price": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "amount": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "checkedOn": {
-                "format": "date",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                "type": "string"
-              },
-              "context": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "currency": {
-                "pattern": "^[A-Z]{3}$",
-                "type": "string"
-              }
-            },
-            "required": [
-              "amount",
-              "currency",
-              "checkedOn",
-              "context"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "referral": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "code": {
-                "type": "string"
-              },
-              "disclosure": {
-                "type": "string"
-              },
-              "offerText": {
-                "type": "string"
-              },
-              "reward": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "reward",
-              "disclosure",
-              "offerText",
-              "code"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "selectionNote": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string"
-            },
-            "url": {
-              "pattern": "^https:\\/\\/",
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "url"
-          ],
-          "type": "object"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "statusText": {
-        "type": "string"
-      },
-      "subcategory": {
-        "type": "string"
-      },
-      "type": {
-        "enum": [
-          "product",
-          "music",
-          "store"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "pattern": "^https:\\/\\/",
-        "type": "string"
-      }
-    },
-    "required": [
-      "id",
-      "number",
-      "type",
-      "name",
-      "url",
-      "category",
-      "subcategory",
-      "description",
-      "attribution",
-      "images",
-      "merchant",
-      "price",
-      "details",
-      "selectionNote",
-      "sources",
-      "referral",
-      "media"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "attribution": {
-        "type": "string"
-      },
-      "category": {
-        "const": "Videos",
-        "type": "string"
-      },
-      "description": {
-        "type": "string"
-      },
-      "details": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string"
-            },
-            "value": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "value"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "id": {
-        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-        "type": "string"
-      },
-      "images": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "alt": {
-              "type": "string"
-            },
-            "url": {
-              "pattern": "^https:\\/\\/",
-              "type": "string"
-            }
-          },
-          "required": [
-            "url",
-            "alt"
-          ],
-          "type": "object"
-        },
-        "maxItems": 0,
-        "type": "array"
-      },
-      "media": {
-        "additionalProperties": false,
-        "properties": {
-          "artworkPurchase": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "badgeUrl": {
-                    "pattern": "^https:\\/\\/",
-                    "type": "string"
-                  },
-                  "label": {
-                    "type": "string"
-                  },
-                  "url": {
-                    "pattern": "^https:\\/\\/",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "url",
-                  "badgeUrl",
-                  "label"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "background": {
-            "anyOf": [
-              {
-                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "caption": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "credit": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "disclosure": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "caption",
-          "disclosure",
-          "credit",
-          "background",
-          "artworkPurchase"
-        ],
-        "type": "object"
-      },
-      "merchant": {
-        "additionalProperties": false,
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "outboundUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          },
-          "productUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          }
-        },
-        "required": [
-          "name",
-          "productUrl",
-          "outboundUrl"
-        ],
-        "type": "object"
-      },
-      "music": {
-        "additionalProperties": false,
-        "properties": {
-          "artist": {
-            "type": "string"
-          },
-          "displayedDuration": {
-            "type": "string"
-          },
-          "embedUrl": {
-            "pattern": "^https:\\/\\/",
-            "type": "string"
-          },
-          "kind": {
-            "enum": [
-              "album",
-              "track"
-            ],
-            "type": "string"
-          },
-          "releaseDate": {
-            "anyOf": [
-              {
-                "format": "date",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "trackCount": {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "artist",
-          "releaseDate",
-          "trackCount",
-          "displayedDuration",
-          "embedUrl"
-        ],
-        "type": "object"
-      },
-      "name": {
-        "type": "string"
-      },
-      "number": {
-        "pattern": "^[0-9]+$",
-        "type": "string"
-      },
-      "price": {
-        "type": "null"
-      },
-      "referral": {
-        "type": "null"
-      },
-      "selectionNote": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string"
-            },
-            "url": {
-              "pattern": "^https:\\/\\/",
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "url"
-          ],
-          "type": "object"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "statusText": {
-        "type": "string"
-      },
-      "subcategory": {
-        "type": "string"
-      },
-      "type": {
-        "const": "video",
-        "type": "string"
-      },
-      "url": {
-        "pattern": "^https:\\/\\/",
-        "type": "string"
-      },
-      "video": {
-        "additionalProperties": false,
-        "properties": {
-          "creator": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "duration": {
-            "pattern": "^PT(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+(?:\\.\\d+)?S)?$",
-            "type": "string"
-          },
-          "embedUrl": {
-            "allOf": [
-              {
-                "pattern": "^https:\\/\\/",
-                "type": "string"
-              },
-              {
-                "pattern": "^https:\\/\\/www\\.youtube-nocookie\\.com\\/embed\\/[A-Za-z0-9_-]{11}$",
-                "type": "string"
-              }
-            ],
-            "type": "string"
-          },
-          "uploadDate": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-            "type": "string"
-          },
-          "url": {
-            "allOf": [
-              {
-                "pattern": "^https:\\/\\/",
-                "type": "string"
-              },
-              {
-                "pattern": "^https:\\/\\/www\\.youtube\\.com\\/(?:channel\\/UC[A-Za-z0-9_-]+|@[A-Za-z0-9_.-]+)$",
-                "type": "string"
-              }
-            ],
-            "type": "string"
-          },
-          "youtubeId": {
-            "pattern": "^[A-Za-z0-9_-]{11}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "youtubeId",
-          "embedUrl",
-          "creator",
-          "url",
-          "uploadDate",
-          "duration"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "id",
-      "number",
-      "type",
-      "name",
-      "url",
-      "category",
-      "subcategory",
-      "description",
-      "attribution",
-      "images",
-      "merchant",
-      "price",
-      "details",
-      "selectionNote",
-      "sources",
-      "referral",
-      "media",
-      "video"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribution": {
+        "type": "string"
+      },
+      "category": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "details": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "value"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+        "type": "string"
+      },
+      "images": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "alt": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "alt"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "media": {
+        "additionalProperties": false,
+        "properties": {
+          "artworkPurchase": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "badgeUrl": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "badgeUrl",
+                  "label"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "caption": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "credit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "disclosure": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "caption",
+          "disclosure",
+          "credit",
+          "background",
+          "artworkPurchase"
+        ],
+        "type": "object"
+      },
+      "merchant": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "outboundUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "productUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "productUrl",
+          "outboundUrl"
+        ],
+        "type": "object"
+      },
+      "music": {
+        "additionalProperties": false,
+        "properties": {
+          "artist": {
+            "type": "string"
+          },
+          "displayedDuration": {
+            "type": "string"
+          },
+          "embedUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "album",
+              "track"
+            ],
+            "type": "string"
+          },
+          "releaseDate": {
+            "anyOf": [
+              {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trackCount": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "artist",
+          "releaseDate",
+          "trackCount",
+          "displayedDuration",
+          "embedUrl"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "number": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "price": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "amount": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "checkedOn": {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              "context": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "currency": {
+                "pattern": "^[A-Z]{3}$",
+                "type": "string"
+              }
+            },
+            "required": [
+              "amount",
+              "currency",
+              "checkedOn",
+              "context"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "referral": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "disclosure": {
+                "type": "string"
+              },
+              "offerText": {
+                "type": "string"
+              },
+              "reward": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "reward",
+              "disclosure",
+              "offerText",
+              "code"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "selectionNote": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "statusText": {
+        "type": "string"
+      },
+      "subcategory": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "product",
+          "music",
+          "store"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "pattern": "^https:\\/\\/",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "number",
+      "type",
+      "name",
+      "url",
+      "category",
+      "subcategory",
+      "description",
+      "attribution",
+      "images",
+      "merchant",
+      "price",
+      "details",
+      "selectionNote",
+      "sources",
+      "referral",
+      "media"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribution": {
+        "type": "string"
+      },
+      "audiobook": {
+        "additionalProperties": false,
+        "properties": {
+          "asin": {
+            "pattern": "^[A-Z0-9]{10}$",
+            "type": "string"
+          },
+          "author": {
+            "pattern": "\\S",
+            "type": "string"
+          },
+          "displayedDuration": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "duration": {
+            "anyOf": [
+              {
+                "pattern": "^PT(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "edition": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "narrator": {
+            "pattern": "\\S",
+            "type": "string"
+          },
+          "releaseDate": {
+            "anyOf": [
+              {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "author",
+          "narrator",
+          "asin",
+          "edition",
+          "displayedDuration",
+          "releaseDate",
+          "duration"
+        ],
+        "type": "object"
+      },
+      "category": {
+        "const": "Listen",
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "details": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "value"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+        "type": "string"
+      },
+      "images": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "alt": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "alt"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "media": {
+        "additionalProperties": false,
+        "properties": {
+          "artworkPurchase": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "badgeUrl": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "badgeUrl",
+                  "label"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "caption": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "credit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "disclosure": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "caption",
+          "disclosure",
+          "credit",
+          "background",
+          "artworkPurchase"
+        ],
+        "type": "object"
+      },
+      "merchant": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "outboundUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "productUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "productUrl",
+          "outboundUrl"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "number": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "price": {
+        "type": "null"
+      },
+      "referral": {
+        "type": "null"
+      },
+      "selectionNote": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "subcategory": {
+        "type": "string"
+      },
+      "type": {
+        "const": "audiobook",
+        "type": "string"
+      },
+      "url": {
+        "pattern": "^https:\\/\\/",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "number",
+      "type",
+      "name",
+      "url",
+      "category",
+      "subcategory",
+      "description",
+      "attribution",
+      "images",
+      "merchant",
+      "price",
+      "details",
+      "selectionNote",
+      "sources",
+      "referral",
+      "media",
+      "audiobook"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribution": {
+        "type": "string"
+      },
+      "category": {
+        "const": "Videos",
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "details": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "value"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+        "type": "string"
+      },
+      "images": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "alt": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "alt"
+          ],
+          "type": "object"
+        },
+        "maxItems": 0,
+        "type": "array"
+      },
+      "media": {
+        "additionalProperties": false,
+        "properties": {
+          "artworkPurchase": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "badgeUrl": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "badgeUrl",
+                  "label"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "caption": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "credit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "disclosure": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "caption",
+          "disclosure",
+          "credit",
+          "background",
+          "artworkPurchase"
+        ],
+        "type": "object"
+      },
+      "merchant": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "outboundUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "productUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "productUrl",
+          "outboundUrl"
+        ],
+        "type": "object"
+      },
+      "music": {
+        "additionalProperties": false,
+        "properties": {
+          "artist": {
+            "type": "string"
+          },
+          "displayedDuration": {
+            "type": "string"
+          },
+          "embedUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "album",
+              "track"
+            ],
+            "type": "string"
+          },
+          "releaseDate": {
+            "anyOf": [
+              {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trackCount": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "artist",
+          "releaseDate",
+          "trackCount",
+          "displayedDuration",
+          "embedUrl"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "number": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "price": {
+        "type": "null"
+      },
+      "referral": {
+        "type": "null"
+      },
+      "selectionNote": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "statusText": {
+        "type": "string"
+      },
+      "subcategory": {
+        "type": "string"
+      },
+      "type": {
+        "const": "video",
+        "type": "string"
+      },
+      "url": {
+        "pattern": "^https:\\/\\/",
+        "type": "string"
+      },
+      "video": {
+        "additionalProperties": false,
+        "properties": {
+          "creator": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "duration": {
+            "pattern": "^PT(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+(?:\\.\\d+)?S)?$",
+            "type": "string"
+          },
+          "embedUrl": {
+            "allOf": [
+              {
+                "pattern": "^https:\\/\\/",
+                "type": "string"
+              },
+              {
+                "pattern": "^https:\\/\\/www\\.youtube-nocookie\\.com\\/embed\\/[A-Za-z0-9_-]{11}$",
+                "type": "string"
+              }
+            ],
+            "type": "string"
+          },
+          "uploadDate": {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          "url": {
+            "allOf": [
+              {
+                "pattern": "^https:\\/\\/",
+                "type": "string"
+              },
+              {
+                "pattern": "^https:\\/\\/www\\.youtube\\.com\\/(?:channel\\/UC[A-Za-z0-9_-]+|@[A-Za-z0-9_.-]+)$",
+                "type": "string"
+              }
+            ],
+            "type": "string"
+          },
+          "youtubeId": {
+            "pattern": "^[A-Za-z0-9_-]{11}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "youtubeId",
+          "embedUrl",
+          "creator",
+          "url",
+          "uploadDate",
+          "duration"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "id",
+      "number",
+      "type",
+      "name",
+      "url",
+      "category",
+      "subcategory",
+      "description",
+      "attribution",
+      "images",
+      "merchant",
+      "price",
+      "details",
+      "selectionNote",
+      "sources",
+      "referral",
+      "media",
+      "video"
+    ],
+    "type": "object"
+  }
+]

Changed5 schema fields changedOct 18, 2026

removedOutput schema / properties / items / items / additionalProperties
```
Removed value: -false
```

addedOutput schema / properties / items / items / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribution": {
+        "type": "string"
+      },
+      "category": {
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "details": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "value"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+        "type": "string"
+      },
+      "images": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "alt": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "alt"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "media": {
+        "additionalProperties": false,
+        "properties": {
+          "artworkPurchase": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "badgeUrl": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "badgeUrl",
+                  "label"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "caption": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "credit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "disclosure": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "caption",
+          "disclosure",
+          "credit",
+          "background",
+          "artworkPurchase"
+        ],
+        "type": "object"
+      },
+      "merchant": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "outboundUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "productUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "productUrl",
+          "outboundUrl"
+        ],
+        "type": "object"
+      },
+      "music": {
+        "additionalProperties": false,
+        "properties": {
+          "artist": {
+            "type": "string"
+          },
+          "displayedDuration": {
+            "type": "string"
+          },
+          "embedUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "album",
+              "track"
+            ],
+            "type": "string"
+          },
+          "releaseDate": {
+            "anyOf": [
+              {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trackCount": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "artist",
+          "releaseDate",
+          "trackCount",
+          "displayedDuration",
+          "embedUrl"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "number": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "price": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "amount": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "checkedOn": {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              "context": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "currency": {
+                "pattern": "^[A-Z]{3}$",
+                "type": "string"
+              }
+            },
+            "required": [
+              "amount",
+              "currency",
+              "checkedOn",
+              "context"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "referral": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "disclosure": {
+                "type": "string"
+              },
+              "offerText": {
+                "type": "string"
+              },
+              "reward": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "reward",
+              "disclosure",
+              "offerText",
+              "code"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "selectionNote": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "statusText": {
+        "type": "string"
+      },
+      "subcategory": {
+        "type": "string"
+      },
+      "type": {
+        "enum": [
+          "product",
+          "music",
+          "store"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "pattern": "^https:\\/\\/",
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "number",
+      "type",
+      "name",
+      "url",
+      "category",
+      "subcategory",
+      "description",
+      "attribution",
+      "images",
+      "merchant",
+      "price",
+      "details",
+      "selectionNote",
+      "sources",
+      "referral",
+      "media"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribution": {
+        "type": "string"
+      },
+      "category": {
+        "const": "Videos",
+        "type": "string"
+      },
+      "description": {
+        "type": "string"
+      },
+      "details": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "value"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "id": {
+        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+        "type": "string"
+      },
+      "images": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "alt": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "alt"
+          ],
+          "type": "object"
+        },
+        "maxItems": 0,
+        "type": "array"
+      },
+      "media": {
+        "additionalProperties": false,
+        "properties": {
+          "artworkPurchase": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "badgeUrl": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "pattern": "^https:\\/\\/",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "badgeUrl",
+                  "label"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "caption": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "credit": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "disclosure": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "caption",
+          "disclosure",
+          "credit",
+          "background",
+          "artworkPurchase"
+        ],
+        "type": "object"
+      },
+      "merchant": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "outboundUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "productUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "productUrl",
+          "outboundUrl"
+        ],
+        "type": "object"
+      },
+      "music": {
+        "additionalProperties": false,
+        "properties": {
+          "artist": {
+            "type": "string"
+          },
+          "displayedDuration": {
+            "type": "string"
+          },
+          "embedUrl": {
+            "pattern": "^https:\\/\\/",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "album",
+              "track"
+            ],
+            "type": "string"
+          },
+          "releaseDate": {
+            "anyOf": [
+              {
+                "format": "date",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trackCount": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "artist",
+          "releaseDate",
+          "trackCount",
+          "displayedDuration",
+          "embedUrl"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "type": "string"
+      },
+      "number": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "price": {
+        "type": "null"
+      },
+      "referral": {
+        "type": "null"
+      },
+      "selectionNote": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "pattern": "^https:\\/\\/",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "statusText": {
+        "type": "string"
+      },
+      "subcategory": {
+        "type": "string"
+      },
+      "type": {
+        "const": "video",
+        "type": "string"
+      },
+      "url": {
+        "pattern": "^https:\\/\\/",
+        "type": "string"
+      },
+      "video": {
+        "additionalProperties": false,
+        "properties": {
+          "creator": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "duration": {
+            "pattern": "^PT(?=\\d)(?:\\d+H)?(?:\\d+M)?(?:\\d+(?:\\.\\d+)?S)?$",
+            "type": "string"
+          },
+          "embedUrl": {
+            "allOf": [
+              {
+                "pattern": "^https:\\/\\/",
+                "type": "string"
+              },
+              {
+                "pattern": "^https:\\/\\/www\\.youtube-nocookie\\.com\\/embed\\/[A-Za-z0-9_-]{11}$",
+                "type": "string"
+              }
+            ],
+            "type": "string"
+          },
+          "uploadDate": {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          "url": {
+            "allOf": [
+              {
+                "pattern": "^https:\\/\\/",
+                "type": "string"
+              },
+              {
+                "pattern": "^https:\\/\\/www\\.youtube\\.com\\/(?:channel\\/UC[A-Za-z0-9_-]+|@[A-Za-z0-9_.-]+)$",
+                "type": "string"
+              }
+            ],
+            "type": "string"
+          },
+          "youtubeId": {
+            "pattern": "^[A-Za-z0-9_-]{11}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "youtubeId",
+          "embedUrl",
+          "creator",
+          "url",
+          "uploadDate",
+          "duration"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "id",
+      "number",
+      "type",
+      "name",
+      "url",
+      "category",
+      "subcategory",
+      "description",
+      "attribution",
+      "images",
+      "merchant",
+      "price",
+      "details",
+      "selectionNote",
+      "sources",
+      "referral",
+      "media",
+      "video"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / items / items / properties

Removed value: -{
-  "attribution": {
-    "type": "string"
-  },
-  "category": {
-    "type": "string"
-  },
-  "description": {
-    "type": "string"
-  },
-  "details": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "name": {
-          "type": "string"
-        },
-        "value": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "name",
-        "value"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "id": {
-    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-    "type": "string"
-  },
-  "images": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "alt": {
-          "type": "string"
-        },
-        "url": {
-          "pattern": "^https:\\/\\/",
-          "type": "string"
-        }
-      },
-      "required": [
-        "url",
-        "alt"
-      ],
-      "type": "object"
-    },
-    "minItems": 1,
-    "type": "array"
-  },
-  "media": {
-    "additionalProperties": false,
-    "properties": {
-      "artworkPurchase": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "badgeUrl": {
-                "pattern": "^https:\\/\\/",
-                "type": "string"
-              },
-              "label": {
-                "type": "string"
-              },
-              "url": {
-                "pattern": "^https:\\/\\/",
-                "type": "string"
-              }
-            },
-            "required": [
-              "url",
-              "badgeUrl",
-              "label"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "background": {
-        "anyOf": [
-          {
-            "pattern": "^#[0-9a-f]{3}(?:[0-9a-f]{3})?$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "caption": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "credit": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "disclosure": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "caption",
-      "disclosure",
-      "credit",
-      "background",
-      "artworkPurchase"
-    ],
-    "type": "object"
-  },
-  "merchant": {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "type": "string"
-      },
-      "outboundUrl": {
-        "pattern": "^https:\\/\\/",
-        "type": "string"
-      },
-      "productUrl": {
-        "pattern": "^https:\\/\\/",
-        "type": "string"
-      }
-    },
-    "required": [
-      "name",
-      "productUrl",
-      "outboundUrl"
-    ],
-    "type": "object"
-  },
-  "music": {
-    "additionalProperties": false,
-    "properties": {
-      "artist": {
-        "type": "string"
-      },
-      "displayedDuration": {
-        "type": "string"
-      },
-      "embedUrl": {
-        "pattern": "^https:\\/\\/",
-        "type": "string"
-      },
-      "kind": {
-        "enum": [
-          "album",
-          "track"
-        ],
-        "type": "string"
-      },
-      "releaseDate": {
-        "anyOf": [
-          {
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "trackCount": {
-        "exclusiveMinimum": 0,
-        "maximum": 9007199254740991,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "artist",
-      "releaseDate",
-      "trackCount",
-      "displayedDuration",
-      "embedUrl"
-    ],
-    "type": "object"
-  },
-  "name": {
-    "type": "string"
-  },
-  "number": {
-    "pattern": "^[0-9]+$",
-    "type": "string"
-  },
-  "price": {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "checkedOn": {
-            "format": "date",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-            "type": "string"
-          },
-          "context": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "currency": {
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency",
-          "checkedOn",
-          "context"
-        ],
-        "type": "object"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "referral": {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "disclosure": {
-            "type": "string"
-          },
-          "offerText": {
-            "type": "string"
-          },
-          "reward": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "reward",
-          "disclosure",
-          "offerText",
-          "code"
-        ],
-        "type": "object"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "selectionNote": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "sources": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "name": {
-          "type": "string"
-        },
-        "url": {
-          "pattern": "^https:\\/\\/",
-          "type": "string"
-        }
-      },
-      "required": [
-        "name",
-        "url"
-      ],
-      "type": "object"
-    },
-    "minItems": 1,
-    "type": "array"
-  },
-  "statusText": {
-    "type": "string"
-  },
-  "subcategory": {
-    "type": "string"
-  },
-  "type": {
-    "enum": [
-      "product",
-      "music",
-      "store"
-    ],
-    "type": "string"
-  },
-  "url": {
-    "pattern": "^https:\\/\\/",
-    "type": "string"
-  }
-}

removedOutput schema / properties / items / items / required

Removed value: -[
-  "id",
-  "number",
-  "type",
-  "name",
-  "url",
-  "category",
-  "subcategory",
-  "description",
-  "attribution",
-  "images",
-  "merchant",
-  "price",
-  "details",
-  "selectionNote",
-  "sources",
-  "referral",
-  "media"
-]

removedOutput schema / properties / items / items / type
```
Removed value: -"object"
```

First observedOct 18, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Annotations already cover read-only/idempotent/non-destructive, and the description adds real context beyond them: the server supplies authoritative public facts (so caller-supplied data is ignored), requested order is preserved, and user selections are ephemeral rather than persisted. Those are behavioral traits an agent could not infer from 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?

Four short sentences, front-loaded with the action and size limit, then prerequisite, then behavioral notes. No filler; every sentence adds a constraint or a caveat.

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?

With an output schema present and only one parameter, nothing about return values needs explaining. The description covers the prerequisite, the input constraint, ordering, and the ephemeral nature of selections — sufficient for an agent to call this correctly.

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 description coverage is 0%, so the description must carry the load, and it does explain provenance (IDs from search_curator/get_curator_item), the 'only those IDs' constraint, and that order is significant. It does not restate the slug format or the 12-item cap relationship to the schema, but the schema already enforces both.

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?

States a specific verb and resource ('Display ... Curator finds as interactive cards in chat') plus a hard scope limit (up to 12). It also implicitly separates itself from the siblings by naming them as the source of IDs, so an agent knows this tool renders rather than retrieves.

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

Usage Guidelines5/5

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

Explicitly prescribes the call sequence: 'First call search_curator or get_curator_item and choose matching IDs. Pass only those IDs.' It also sets a negative boundary — selections are not a saved wishlist — so the agent knows what this tool must not be used for.

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

All The Curator 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.

Resources

Need Help?