campaignstack

campaignstack_get_exclusions

Read-onlyIdempotent

Get exclusion policy rows with a stable {items,pagination} shape. Target workspace returns level-0 policy; target signal_agent or workflow returns the effective cascade (workspace policy plus that consumer's additive exclusions). Use include.manualProfiles with a cap to inspect bounded manual profile samples.

Input Schema

TableJSON Schema

Name	Required	Description
`ids`	No	Optional exclusion ids to fetch after the target cascade is resolved.
`limit`	No	Maximum items to return, capped at 100.
`cursor`	No	Opaque pagination cursor.
`filters`	No
`include`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`items`	No
`warnings`	No
`missingIds`	No
`pagination`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 29, 2026

changedInput schema / properties / filters / properties / workspaceId / description

Previous value: -"Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach."New value: +"Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too."

Changed19 schema fields changedSep 26, 2026

addedInput schema / properties / cursor

Added value: +{
+  "description": "Opaque pagination cursor.",
+  "maxLength": 1000,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / filters

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "enabled": {
+      "description": "Filter by enabled state after the cascade is resolved.",
+      "type": "boolean"
+    },
+    "signalAgentId": {
+      "description": "Required when target is signal_agent.",
+      "type": "string"
+    },
+    "target": {
+      "default": "workspace",
+      "description": "workspace returns level-0 exclusions. signal_agent/workflow returns the effective cascade for that consumer.",
+      "enum": [
+        "workspace",
+        "signal_agent",
+        "workflow"
+      ],
+      "type": "string"
+    },
+    "type": {
+      "description": "Filter by exclusion entry type such as manual, csv, filter, or lead_list.",
+      "type": "string"
+    },
+    "workflowId": {
+      "description": "Required when target is workflow.",
+      "type": "string"
+    },
+    "workspaceId": {
+      "description": "Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / ids

Added value: +{
+  "description": "Optional exclusion ids to fetch after the target cascade is resolved.",
+  "items": {
+    "maxLength": 200,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 100,
+  "minItems": 1,
+  "type": "array"
+}

addedInput schema / properties / include

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "manualProfiles": {
+      "additionalProperties": false,
+      "description": "For manual exclusion entries, include a bounded sample of LinkedIn profile rows.",
+      "properties": {
+        "limit": {
+          "default": 10,
+          "description": "Maximum manual profile rows per manual exclusion.",
+          "maximum": 25,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

removedInput schema / properties / level

Removed value: -{
-  "description": "workspace (default) returns the level-0 list alone. effective returns level 0 merged with the level-1 extras of the consumer named by signalAgentId or workflowId, which is what the pipeline applies.",
-  "enum": [
-    "workspace",
-    "effective"
-  ],
-  "type": "string"
-}

addedInput schema / properties / limit

Added value: +{
+  "default": 50,
+  "description": "Maximum items to return, capped at 100.",
+  "maximum": 100,
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / signalAgentId

Removed value: -{
-  "description": "With level=effective, merge this signal agent's own exclusions",
-  "type": "string"
-}

removedInput schema / properties / workflowId

Removed value: -{
-  "description": "With level=effective, merge this workflow source node's own exclusions",
-  "type": "string"
-}

removedInput schema / properties / workspaceId

Removed value: -{
-  "description": "Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach.",
-  "type": "string"
-}

removedOutput schema / properties / effective

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "items": {},
-          "type": "array"
-        }
-      ],
-      "description": "Enabled entries only, level 0 first"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Enabled entries only, level 0 first"
-}

removedOutput schema / properties / exclusions

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "items": {},
-          "type": "array"
-        }
-      ],
-      "description": "Level-0 exclusion entries"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Level-0 exclusion entries"
-}

addedOutput schema / properties / items

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "includes": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "properties": {
+                  "latestPosts": {
+                    "anyOf": [
+                      {
+                        "items": {},
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "leads": {
+                    "anyOf": [
+                      {
+                        "items": {},
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "manualProfiles": {
+                    "anyOf": [
+                      {
+                        "items": {},
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "stats": {
+                    "anyOf": [
+                      {},
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "type": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "workspaceId": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / properties / level0

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "items": {},
-          "type": "array"
-        }
-      ]
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

removedOutput schema / properties / level1

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "items": {},
-          "type": "array"
-        }
-      ]
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

removedOutput schema / properties / level1Source

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      ]
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

addedOutput schema / properties / missingIds

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / pagination

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "properties": {
+        "hasMore": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "nextCursor": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "totalCount": {
+          "description": "Total matching rows when known",
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / warnings

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "field": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "message": {
+            "anyOf": [
+              {
+                "maxLength": 500,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / properties / workspaceId

Removed value: -{
-  "anyOf": [
-    {
-      "anyOf": [
-        {
-          "not": {}
-        },
-        {
-          "type": "string"
-        }
-      ]
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

Changed1 schema field changedSep 20, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "effective": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "items": {},
+              "type": "array"
+            }
+          ],
+          "description": "Enabled entries only, level 0 first"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Enabled entries only, level 0 first"
+    },
+    "exclusions": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "items": {},
+              "type": "array"
+            }
+          ],
+          "description": "Level-0 exclusion entries"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Level-0 exclusion entries"
+    },
+    "level0": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "items": {},
+              "type": "array"
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "level1": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "items": {},
+              "type": "array"
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "level1Source": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "workspaceId": {
+      "anyOf": [
+        {
+          "anyOf": [
+            {
+              "not": {}
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedSep 13, 2026

changedInput schema / properties / workspaceId / description

Previous value: -"Workspace ID (required for user keys; workspace keys are bound)"New value: +"Workspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach."

Changed1 schema field changedSep 6, 2026

changedInput schema / properties / workspaceId / description

Previous value: -"Defaults to the API key's workspace"New value: +"Workspace ID (required for user keys; workspace keys are bound)"

First observedSep 4, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive, so the bar is lower; the description still adds real value by disclosing the cascade-resolution behavior (level-0 workspace policy vs. effective cascade with a consumer's additive exclusions) and the bounded nature of manual profile sampling.

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?

Four tight, front-loaded sentences with no filler; the return shape and target semantics come first and the optional-sampling tip last. Slightly dense but every sentence carries information.

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

Completeness4/5

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

An output schema exists, so return values needn't be spelled out, and the description still sketches the {items,pagination} envelope. Combined with the cascade explanation for a 5-param nested tool, it is nearly complete; only the ids/cursor semantics are left entirely to the schema.

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?

With 60% schema coverage the schema carries much of the load, and the description's explanation of target semantics largely restates the schema's own target description. It adds nothing about ids, cursor, or limit behavior, so it neither compensates for nor exceeds the schema.

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?

States a specific verb+resource ('Get exclusion policy rows') and immediately clarifies the return shape ({items,pagination}). It distinguishes the two target modes well, but never names the obvious sibling edit_exclusions, so an agent must infer the read/write split from the name alone.

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 concrete usage direction for the non-obvious path ('Use include.manualProfiles with a cap to inspect bounded manual profile samples') and explains which target produces which result set. It stops short of naming the alternative tool or an explicit when-not condition.

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

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