Synoptic

Create a Synoptic collection

create_collection

Destructive

Create a collection in the signed-in user’s stream deck from existing Synoptic streams and return collection metadata. Automatically follows eligible selected sources and may consume invitations; backfills matching stored posts. Optional saved AI filters process incoming posts and can use the account’s AI allowance. Repeated successful calls create separate collections. Does not purchase stream access or create upstream collectors.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes	Display name for the new collection.
`filters`	No	Optional include/exclude keywords, /pattern/flags regex, and highlighting settings. The ai value is an existing saved filter ID from list_ai_filters; using it can consume the account’s AI allowance. Defaults to no filters.
`sources`	Yes	Existing Synoptic stream IDs. For followed custom-target streams, customTargets narrows saved selections; omit it to use all saved targets. Stream owners receive all targets. Optional sourceIds narrows to known constituent source IDs already routed to the stream; omit it for all sources.
`highlights`	No	Optional enabled state and regex/color rules for highlighting matching text.
`streamDeckId`	Yes	ID of a stream deck owned by the signed-in user, from list_stream_decks.
`matchingSourcesOnly`	No	Restrict the collection’s 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"

Changed33 schema fields changedOct 18, 2026

removedInput schema / properties / filters / properties / ai / $ref

Removed value: -"#/properties/sources/items/properties/streamId"

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 / 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"
```

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/sources/items/properties/streamId"
-    },
-    "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"

addedInput schema / properties / sources / items / properties / streamId / description
```
Added value: +"Synoptic stream ID from search or streams_all"
```

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.4/5.0

Behavior5/5

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

Annotations declare the safety profile (destructiveHint true, non-idempotent, openWorld), and the description adds substantial beyond-schema behavior: auto-following eligible sources, possible invitation consumption, backfilling of stored posts, AI-allowance consumption, and that repeated successful calls create separate collections. This is exactly the side-effect disclosure an agent needs for a mutating 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-loaded with the core action and followed by side-effect caveats in separate, purposeful sentences. Dense but each clause carries information; only slight redundancy between the follow/backfill statements.

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 a rich output schema, full annotations, and 100% schema coverage, the description only needs to supply side-effect and scope context – which it does comprehensively. Nothing needed to invoke it correctly is missing.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all six parameters thoroughly (filters.ai, regex, highlights, sources, etc.). The description adds the AI-filter/allowance context but no parameter syntax or format details beyond that, so the baseline 3 is appropriate.

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 precise verb+resource ('Create a collection in the signed-in user's stream deck from existing Synoptic streams') and clarifies the return ('collection metadata'), which distinguishes it from siblings like create_stream, create_stream_deck, and create_stream_post.

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?

Provides real usage context: it explicitly says what the tool does NOT do ('Does not purchase stream access or create upstream collectors'), which routes agents away from wrong expectations. It stops short of naming a sibling alternative or stating when-not-to-use it, so it is clear context without explicit alternatives.

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?