Synoptic

Update collection

update_collection

Destructive

Replace a custom collection’s name, source list, filters, and highlights. Read get_collection first and preserve desired settings: omitted filters, highlights and AI filter are cleared, matchingSourcesOnly becomes false, and columnWidth resets to null. In the server-managed Related news collection, sources only tune its existing streams and matchingSourcesOnly stays true. Automatically follows eligible sources, may consume invitations, and rebuilds the stored collection feed. An attached AI filter processes incoming posts and can use the account’s AI allowance.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	Collection ID from list_collections
`name`	Yes	Collection display name
`filters`	No	Keyword, regex, highlight and AI filters; defaults to none
`sources`	Yes	Source streams whose posts feed the collection
`highlights`	No	Highlight rules for post text in the Synoptic app
`streamDeckId`	Yes	Deck ID from list_stream_decks
`matchingSourcesOnly`	No	Restrict the Synoptic app source picker to streams with market matching; defaults to false

Output Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	ID of this item for the tools that take it
`name`	Yes	Display name
`filters`	Yes
`aiFilterId`	No	Attached AI filter ID for get_ai_filter; null when none
`highlights`	No
`columnWidth`	No	Column width in pixels from set_collection_column_width; null when unset
`matchingSourcesOnly`	No	Whether the Synoptic app source picker shows only streams with market matching

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedOct 18, 2026

changedInput schema / properties / filters / properties / highlightColor / description

Previous value: -"Synoptic app color for text matching includeKeywords and regex, such as lightYellow"New value: +"Synoptic app color for text matching includeKeywords and regex: one of lightYellow, lightOrange, lightTeal, lightBlue, yellow, green, blue, red, orange, purple"

changedInput schema / properties / filters / properties / includeKeywords / description

Previous value: -"Keep only posts matching every field set here; matching is a case-insensitive substring test"New value: +"Keep only posts matching every field set here; matching is case-insensitive"

changedInput schema / properties / highlights / properties / values / items / properties / color / description

Previous value: -"Synoptic app color for matching text, such as lightYellow, green or red"New value: +"Synoptic app color for matching text: one of lightYellow, lightOrange, lightTeal, lightBlue, yellow, green, blue, red, orange, purple"

changedOutput schema / properties / highlights / anyOf

Previous 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"
+  }
+]

changedOutput schema / properties / id / description

Previous 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"

Changed48 schema fields changedOct 18, 2026

addedInput schema / properties / filters / description

Added value: +"Keyword, regex, highlight and AI filters; defaults to none"

removedInput schema / properties / filters / properties / ai / $ref
```
Removed value: -"#/properties/streamDeckId"
```

addedInput schema / properties / filters / properties / ai / description

Added value: +"AI filter ID from list_ai_filters to apply to incoming posts"

addedInput schema / properties / filters / properties / ai / maxLength
```
Added value: +128
```
addedInput schema / properties / filters / properties / ai / minLength
```
Added value: +1
```
addedInput schema / properties / filters / properties / ai / type
```
Added value: +"string"
```
removedInput schema / properties / filters / properties / excludeKeywords / $ref
```
Removed value: -"#/properties/filters/properties/includeKeywords"
```
addedInput schema / properties / filters / properties / excludeKeywords / additionalProperties
```
Added value: +false
```

addedInput schema / properties / filters / properties / excludeKeywords / description

Added value: +"Drop posts matching any field set here: all drops posts containing every word, any drops posts containing any of them, phrase drops posts containing the phrase"

addedInput schema / properties / filters / properties / excludeKeywords / properties

Added value: +{
+  "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"
+  }
+}

addedInput schema / properties / filters / properties / excludeKeywords / type
```
Added value: +"object"
```

addedInput schema / properties / filters / properties / highlightColor / description

Added value: +"Synoptic app color for text matching includeKeywords and regex, such as lightYellow"

addedInput schema / properties / filters / properties / includeKeywords / description

Added value: +"Keep only posts matching every field set here; matching is a case-insensitive substring test"

addedInput schema / properties / filters / properties / includeKeywords / properties / all / description
```
Added value: +"Space-separated words; a post matches when its text contains every word"
```
addedInput schema / properties / filters / properties / includeKeywords / properties / any / description
```
Added value: +"Space-separated words; a post matches when its text contains at least one word"
```
addedInput schema / properties / filters / properties / includeKeywords / properties / phrase / description
```
Added value: +"Exact phrase; a post matches when its text contains it"
```

addedInput schema / properties / filters / properties / isHighlightEnabled / description

Added value: +"Highlight text matching includeKeywords and regex in the Synoptic app"

addedInput schema / properties / filters / properties / regex / description

Added value: +"Keep only posts whose text matches this /pattern/flags regex"

addedInput schema / properties / highlights / description

Added value: +"Highlight rules for post text in the Synoptic app"

addedInput schema / properties / highlights / properties / isEnabled / description
```
Added value: +"Whether the highlight rules apply"
```
addedInput schema / properties / highlights / properties / values / description
```
Added value: +"Rules that mark matching post text with a color"
```
addedInput schema / properties / highlights / properties / values / items / properties / color / description
```
Added value: +"Synoptic app color for matching text, such as lightYellow, green or red"
```
addedInput schema / properties / highlights / properties / values / items / properties / regex / description
```
Added value: +"Regular expression, either bare (case-insensitive) or /pattern/flags"
```

removedInput schema / properties / id / $ref

Removed value: -"#/properties/streamDeckId"

addedInput schema / properties / id / description

Added value: +"Collection ID from list_collections"

addedInput schema / properties / id / maxLength
```
Added value: +128
```
addedInput schema / properties / id / minLength
```
Added value: +1
```
addedInput schema / properties / id / type
```
Added value: +"string"
```

addedInput schema / properties / matchingSourcesOnly / description

Added value: +"Restrict the Synoptic app source picker to streams with market matching; defaults to false"

addedInput schema / properties / name / description
```
Added value: +"Collection display name"
```

addedInput schema / properties / sources / description

Added value: +"Source streams whose posts feed the collection"

addedInput schema / properties / sources / items / properties / customTargets / description

Added value: +"For a followed custom-target stream, the saved targets to include, from get_stream_custom_targets; omit for all of them. Not allowed on other streams; ignored on streams the user owns, which include every target"

changedInput schema / properties / sources / items / properties / sourceIds / anyOf

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/properties/streamDeckId"
-    },
-    "maxItems": 100,
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "maxLength": 128,
+      "minLength": 1,
+      "type": "string"
+    },
+    "maxItems": 100,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / sources / items / properties / sourceIds / description

Added value: +"Source IDs already routed to this stream to include, such as a post’s sourceId; omit or [] for every source"

removedInput schema / properties / sources / items / properties / streamId / $ref
```
Removed value: -"#/properties/streamDeckId"
```
addedInput schema / properties / sources / items / properties / streamId / description
```
Added value: +"Synoptic stream ID from search or streams_all"
```
addedInput schema / properties / sources / items / properties / streamId / maxLength
```
Added value: +128
```
addedInput schema / properties / sources / items / properties / streamId / minLength
```
Added value: +1
```
addedInput schema / properties / sources / items / properties / streamId / type
```
Added value: +"string"
```
addedInput schema / properties / streamDeckId / description
```
Added value: +"Deck ID from list_stream_decks"
```

addedOutput schema / properties / aiFilterId / description

Added value: +"Attached AI filter ID for get_ai_filter; null when none"

addedOutput schema / properties / columnWidth / description

Added value: +"Column width in pixels from set_collection_column_width; null when unset"

changedOutput schema / properties / filters / properties / excludeKeywords / anyOf

Previous value: -[
-  {
-    "$ref": "#/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"
+  }
+]

changedOutput schema / properties / filters / properties / includeKeywords / anyOf

Previous 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"
+  }
+]

changedOutput schema / properties / highlights / anyOf

Previous 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"
+  }
+]

addedOutput schema / properties / id / description

Added value: +"ID to pass to this item’s get, update, delete or reorder tools"

addedOutput schema / properties / matchingSourcesOnly / description

Added value: +"Whether the Synoptic app source picker shows only streams with market matching"

addedOutput schema / properties / name / description
```
Added value: +"Display name"
```

First observedOct 17, 2026

TDQS

A4.3/5.0

Behavior5/5

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

Annotations already flag destructive and non-idempotent, but the description adds substantial context beyond them: omitted filters/highlights/AI filter are cleared, matchingSourcesOnly becomes false, columnWidth resets to null, and it auto-follows sources, may consume invitations, rebuilds the feed, and can consume AI allowance. These are exactly the side effects an agent needs before invoking a destructive tool.

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

Conciseness4/5

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

Front-loads the core action, then layers the destructive-clear semantics, the server-managed special case, and the follow/invitation/AI side effects in dense but non-redundant sentences. Each sentence carries unique behavior; it is long but almost entirely earned.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter destructive mutation with nested objects, the description covers prerequisites, destructive defaults, special-case semantics, and external side effects; with an output schema present it need not describe returns. Nothing material is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the 3 baseline applies, but the description adds real meaning absent from the schema: clearing behavior for omitted optional fields, the matchingSourcesOnly reset, and the columnWidth-to-null reset (a field not even present in the schema). This is meaningfully more than the schema conveys.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource: 'Replace a custom collection's name, source list, filters, and highlights.' This tells the agent exactly what mutation occurs. It does not explicitly differentiate from create_collection or set_collection_column_width, but the 'Replace' semantics and the filename-level fields are unambiguous.

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

Usage Guidelines4/5

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

Gives actionable context: 'Read get_collection first and preserve desired settings,' and spells out the conditions under which omitted fields are cleared. It stops short of naming sibling alternatives (e.g., when to create vs update), but the read-first prerequisite is genuine guidance.

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

All Synoptic 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?