list_collectionsList the signed-in user’s custom collections in a stream deck, in display order. Use get_collection for source streams and target selections.
| Name | Required | Description | Default |
|---|---|---|---|
| streamDeckId | Yes | Deck ID from list_stream_decks |
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes |
Changes observed during successful MCP inspections.
Output schema / properties / items / items / properties / highlights / anyOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "isEnabled": {
- "description": "Whether the highlight rules apply",
- "type": "boolean"
- },
- "values": {
- "description": "Rules that mark matching post text with a color",
- "items": {
- "additionalProperties": false,
- "properties": {
- "color": {
- "description": "Synoptic app color for matching text, such as lightYellow, green or red",
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- },
- "regex": {
- "description": "Regular expression, either bare (case-insensitive) or /pattern/flags",
- "maxLength": 4000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "regex",
- "color"
- ],
- "type": "object"
- },
- "maxItems": 15,
- "type": "array"
- }
- },
- "required": [
- "isEnabled",
- "values"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "isEnabled": {
+ "description": "Whether the highlight rules apply",
+ "type": "boolean"
+ },
+ "values": {
+ "description": "Rules that mark matching post text with a color",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "color": {
+ "description": "Synoptic app color for matching text: one of lightYellow, lightOrange, lightTeal, lightBlue, yellow, green, blue, red, orange, purple",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "regex": {
+ "description": "Regular expression, either bare (case-insensitive) or /pattern/flags",
+ "maxLength": 4000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "regex",
+ "color"
+ ],
+ "type": "object"
+ },
+ "maxItems": 15,
+ "type": "array"
+ }
+ },
+ "required": [
+ "isEnabled",
+ "values"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / items / items / properties / id / descriptionPrevious value: -"ID to pass to this item’s get, update, delete or reorder tools"New value: +"ID of this item for the tools that take it"Input schema / properties / streamDeckId / descriptionAdded value: +"Deck ID from list_stream_decks"Output schema / properties / items / items / properties / aiFilterId / descriptionAdded value: +"Attached AI filter ID for get_ai_filter; null when none"Output schema / properties / items / items / properties / columnWidth / descriptionAdded value: +"Column width in pixels from set_collection_column_width; null when unset"Output schema / properties / items / items / properties / filters / properties / excludeKeywords / anyOfPrevious value: -[
- {
- "$ref": "#/properties/items/items/properties/filters/properties/includeKeywords/anyOf/0"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "all": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Space-separated words; a post matches when its text contains every word"
+ },
+ "any": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Space-separated words; a post matches when its text contains at least one word"
+ },
+ "phrase": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Exact phrase; a post matches when its text contains it"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / items / items / properties / filters / properties / includeKeywords / anyOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "all": {
- "anyOf": [
- {
- "maxLength": 4000,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "any": {
- "anyOf": [
- {
- "maxLength": 4000,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "phrase": {
- "anyOf": [
- {
- "maxLength": 4000,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "all": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Space-separated words; a post matches when its text contains every word"
+ },
+ "any": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Space-separated words; a post matches when its text contains at least one word"
+ },
+ "phrase": {
+ "anyOf": [
+ {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Exact phrase; a post matches when its text contains it"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / items / items / properties / highlights / anyOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "isEnabled": {
- "type": "boolean"
- },
- "values": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "color": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- },
- "regex": {
- "maxLength": 4000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "regex",
- "color"
- ],
- "type": "object"
- },
- "maxItems": 15,
- "type": "array"
- }
- },
- "required": [
- "isEnabled",
- "values"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "isEnabled": {
+ "description": "Whether the highlight rules apply",
+ "type": "boolean"
+ },
+ "values": {
+ "description": "Rules that mark matching post text with a color",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "color": {
+ "description": "Synoptic app color for matching text, such as lightYellow, green or red",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "regex": {
+ "description": "Regular expression, either bare (case-insensitive) or /pattern/flags",
+ "maxLength": 4000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "regex",
+ "color"
+ ],
+ "type": "object"
+ },
+ "maxItems": 15,
+ "type": "array"
+ }
+ },
+ "required": [
+ "isEnabled",
+ "values"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+]Output schema / properties / items / items / properties / id / descriptionAdded value: +"ID to pass to this item’s get, update, delete or reorder tools"Output schema / properties / items / items / properties / matchingSourcesOnly / descriptionAdded value: +"Whether the Synoptic app source picker shows only streams with market matching"Output schema / properties / items / items / properties / name / descriptionAdded value: +"Display name"Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover readOnly, idempotent, non-destructive, and closed-world, so the safety profile is fully handled structurally. The description adds genuine extra behavior: results are scoped to the signed-in user and returned in display order, which the annotations do not convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences, zero filler. The core action and scope are front-loaded, and the alternative-tool routing is a single trailing clause that earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return values need no explanation, and annotations cover the safety profile. Purpose, scope, ordering, and one alternative are all covered; only the relationship to adjacent tools like list_stream_decks and reorder_collections is left implicit.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single streamDeckId parameter is documented in-schema as 'Deck ID from list_stream_decks'. The description only alludes to it via 'in a stream deck' and adds no format or sourcing detail beyond the schema, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (List), resource (custom collections), and scope (signed-in user's, within a stream deck, in display order). It also names the sibling get_collection so an agent can distinguish this list tool from the single-resource fetch without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives a clear use context (listing the signed-in user's collections in a given deck) and explicitly routes one case to get_collection. It stops short of stating when-not to use it (e.g., reorder_collections or the list_stream_decks prerequisite), so it is strong but not exhaustive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.