--deprecated

This connector has been deprecated

Replaced by io.github.no-fait/infinite-audience

Discovery Overlap

discovery_overlap

Calculate the overlap between two audience criteria sets. Returns overlap_count, overlap_pct (percentage of the smaller population), and demographic_deltas. Each side (a and b) independently accepts EXACTLY ONE of: audience_id, segment_id, segment_ids+set_logic, filter_groups, or filters (more than one per side is rejected with AMBIGUOUS_INPUT). Saved composition, exclusions, and record limits are preserved. Empty optional distributions mean unavailable, not zero. Legacy: pass audience_id_a and audience_id_b at the top level for backward compatibility (mutually exclusive with a/b). Requires 'discovery' scope.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "discovery_overlap"
  }
}

Input Schema

Name	Required	Description
`a`	No	Side A input — any of the five discovery input shapes
`b`	No	Side B input — any of the five discovery input shapes
`audience_id_a`	No	(Legacy) First audience ID
`audience_id_b`	No	(Legacy) Second audience ID

Output Schema

Name	Required	Description
`a_name`	Yes
`b_name`	Yes
`a_count`	Yes
`b_count`	Yes
`guidance`	No	Interpretation or recovery guidance for this result
`warnings`	No
`count_unit`	No
`page_count`	No	Number of objects on this page, not the organization total
`count_state`	No	Unknown means no count; available does not guarantee freshness. Recount for a current value.
`overlap_pct`	Yes
`next_actions`	No	Suggested next calls using returned IDs and available scopes. Not executed and not user consent.
`overlap_count`	Yes
`population_input`	No	Population input used for the preview; IDs refer to their current saved definitions
`demographic_deltas`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed17 schema fields changedNov 6, 2026

changedInput schema / properties / a / properties / filter_groups / items / additionalProperties
```
Previous value: -{}New value: +false
```

addedInput schema / properties / a / properties / filter_groups / items / properties

Added value: +{
+  "combinator": {
+    "description": "Join to the preceding included group; ignored for the first group. AND binds before OR. Exclusion groups always subtract.",
+    "enum": [
+      "AND",
+      "OR"
+    ],
+    "type": "string"
+  },
+  "filters": {
+    "description": "All conditions in this group must match",
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "description": "field_name from get_field_catalog; ZIP5 also accepts zip, zip_code or postal_code. Use published operators and enum_values",
+          "minLength": 1,
+          "type": "string"
+        },
+        "op": {
+          "enum": [
+            "=",
+            "!=",
+            "<",
+            "<=",
+            ">",
+            ">=",
+            "IN",
+            "NOT IN",
+            "BETWEEN",
+            "LIKE",
+            "ARRAY_CONTAINS",
+            "ARRAY_CONTAINS_ANY",
+            "IS NULL",
+            "IS NOT NULL"
+          ],
+          "type": "string"
+        },
+        "text_comparison": {
+          "description": "STRING =, !=, IN, NOT IN, LIKE and ARRAY<STRING> ARRAY_CONTAINS, ARRAY_CONTAINS_ANY. Default exact. case_insensitive applies Unicode case folding to stored text and the supplied value; use when capitalization is incidental.",
+          "enum": [
+            "exact",
+            "case_insensitive"
+          ],
+          "type": "string"
+        },
+        "trim_whitespace": {
+          "description": "Supported STRING or ARRAY<STRING> comparisons only. Trim leading/trailing whitespace on both sides; default false.",
+          "type": "boolean"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Scalar for comparisons; array for IN/NOT IN; ARRAY_CONTAINS_ANY matches any listed value; [lower, upper] inclusive for BETWEEN; LIKE uses % for any sequence and _ for one character; omit for IS NULL/IS NOT NULL. Use enum_values codes, not display labels"
+        }
+      },
+      "required": [
+        "field",
+        "op"
+      ],
+      "type": "object"
+    },
+    "minItems": 1,
+    "type": "array"
+  },
+  "id": {
+    "description": "Caller-chosen group ID, for example geography; prefix _exclude:: to subtract this group",
+    "minLength": 1,
+    "type": "string"
+  }
+}

removedInput schema / properties / a / properties / filter_groups / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / a / properties / filter_groups / items / required
```
Added value: +[
+  "id",
+  "combinator",
+  "filters"
+]
```
changedInput schema / properties / a / properties / filters / items / additionalProperties
```
Previous value: -{}New value: +false
```

addedInput schema / properties / a / properties / filters / items / properties

Added value: +{
+  "field": {
+    "description": "field_name from get_field_catalog; ZIP5 also accepts zip, zip_code or postal_code. Use published operators and enum_values",
+    "minLength": 1,
+    "type": "string"
+  },
+  "op": {
+    "enum": [
+      "=",
+      "!=",
+      "<",
+      "<=",
+      ">",
+      ">=",
+      "IN",
+      "NOT IN",
+      "BETWEEN",
+      "LIKE",
+      "ARRAY_CONTAINS",
+      "ARRAY_CONTAINS_ANY",
+      "IS NULL",
+      "IS NOT NULL"
+    ],
+    "type": "string"
+  },
+  "text_comparison": {
+    "description": "STRING =, !=, IN, NOT IN, LIKE and ARRAY<STRING> ARRAY_CONTAINS, ARRAY_CONTAINS_ANY. Default exact. case_insensitive applies Unicode case folding to stored text and the supplied value; use when capitalization is incidental.",
+    "enum": [
+      "exact",
+      "case_insensitive"
+    ],
+    "type": "string"
+  },
+  "trim_whitespace": {
+    "description": "Supported STRING or ARRAY<STRING> comparisons only. Trim leading/trailing whitespace on both sides; default false.",
+    "type": "boolean"
+  },
+  "value": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "number"
+      },
+      {
+        "type": "boolean"
+      },
+      {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Scalar for comparisons; array for IN/NOT IN; ARRAY_CONTAINS_ANY matches any listed value; [lower, upper] inclusive for BETWEEN; LIKE uses % for any sequence and _ for one character; omit for IS NULL/IS NOT NULL. Use enum_values codes, not display labels"
+  }
+}

removedInput schema / properties / a / properties / filters / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / a / properties / filters / items / required
```
Added value: +[
+  "field",
+  "op"
+]
```
changedInput schema / properties / b / properties / filter_groups / items / additionalProperties
```
Previous value: -{}New value: +false
```

addedInput schema / properties / b / properties / filter_groups / items / properties

Added value: +{
+  "combinator": {
+    "description": "Join to the preceding included group; ignored for the first group. AND binds before OR. Exclusion groups always subtract.",
+    "enum": [
+      "AND",
+      "OR"
+    ],
+    "type": "string"
+  },
+  "filters": {
+    "description": "All conditions in this group must match",
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "description": "field_name from get_field_catalog; ZIP5 also accepts zip, zip_code or postal_code. Use published operators and enum_values",
+          "minLength": 1,
+          "type": "string"
+        },
+        "op": {
+          "enum": [
+            "=",
+            "!=",
+            "<",
+            "<=",
+            ">",
+            ">=",
+            "IN",
+            "NOT IN",
+            "BETWEEN",
+            "LIKE",
+            "ARRAY_CONTAINS",
+            "ARRAY_CONTAINS_ANY",
+            "IS NULL",
+            "IS NOT NULL"
+          ],
+          "type": "string"
+        },
+        "text_comparison": {
+          "description": "STRING =, !=, IN, NOT IN, LIKE and ARRAY<STRING> ARRAY_CONTAINS, ARRAY_CONTAINS_ANY. Default exact. case_insensitive applies Unicode case folding to stored text and the supplied value; use when capitalization is incidental.",
+          "enum": [
+            "exact",
+            "case_insensitive"
+          ],
+          "type": "string"
+        },
+        "trim_whitespace": {
+          "description": "Supported STRING or ARRAY<STRING> comparisons only. Trim leading/trailing whitespace on both sides; default false.",
+          "type": "boolean"
+        },
+        "value": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Scalar for comparisons; array for IN/NOT IN; ARRAY_CONTAINS_ANY matches any listed value; [lower, upper] inclusive for BETWEEN; LIKE uses % for any sequence and _ for one character; omit for IS NULL/IS NOT NULL. Use enum_values codes, not display labels"
+        }
+      },
+      "required": [
+        "field",
+        "op"
+      ],
+      "type": "object"
+    },
+    "minItems": 1,
+    "type": "array"
+  },
+  "id": {
+    "description": "Caller-chosen group ID, for example geography; prefix _exclude:: to subtract this group",
+    "minLength": 1,
+    "type": "string"
+  }
+}

removedInput schema / properties / b / properties / filter_groups / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / b / properties / filter_groups / items / required
```
Added value: +[
+  "id",
+  "combinator",
+  "filters"
+]
```
changedInput schema / properties / b / properties / filters / items / additionalProperties
```
Previous value: -{}New value: +false
```

addedInput schema / properties / b / properties / filters / items / properties

Added value: +{
+  "field": {
+    "description": "field_name from get_field_catalog; ZIP5 also accepts zip, zip_code or postal_code. Use published operators and enum_values",
+    "minLength": 1,
+    "type": "string"
+  },
+  "op": {
+    "enum": [
+      "=",
+      "!=",
+      "<",
+      "<=",
+      ">",
+      ">=",
+      "IN",
+      "NOT IN",
+      "BETWEEN",
+      "LIKE",
+      "ARRAY_CONTAINS",
+      "ARRAY_CONTAINS_ANY",
+      "IS NULL",
+      "IS NOT NULL"
+    ],
+    "type": "string"
+  },
+  "text_comparison": {
+    "description": "STRING =, !=, IN, NOT IN, LIKE and ARRAY<STRING> ARRAY_CONTAINS, ARRAY_CONTAINS_ANY. Default exact. case_insensitive applies Unicode case folding to stored text and the supplied value; use when capitalization is incidental.",
+    "enum": [
+      "exact",
+      "case_insensitive"
+    ],
+    "type": "string"
+  },
+  "trim_whitespace": {
+    "description": "Supported STRING or ARRAY<STRING> comparisons only. Trim leading/trailing whitespace on both sides; default false.",
+    "type": "boolean"
+  },
+  "value": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "number"
+      },
+      {
+        "type": "boolean"
+      },
+      {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            }
+          ]
+        },
+        "type": "array"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Scalar for comparisons; array for IN/NOT IN; ARRAY_CONTAINS_ANY matches any listed value; [lower, upper] inclusive for BETWEEN; LIKE uses % for any sequence and _ for one character; omit for IS NULL/IS NOT NULL. Use enum_values codes, not display labels"
+  }
+}

removedInput schema / properties / b / properties / filters / items / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
addedInput schema / properties / b / properties / filters / items / required
```
Added value: +[
+  "field",
+  "op"
+]
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "a_count": {
+      "type": "number"
+    },
+    "a_name": {
+      "type": "string"
+    },
+    "b_count": {
+      "type": "number"
+    },
+    "b_name": {
+      "type": "string"
+    },
+    "count_state": {
+      "description": "Unknown means no count; available does not guarantee freshness. Recount for a current value.",
+      "enum": [
+        "unknown",
+        "available"
+      ],
+      "type": "string"
+    },
+    "count_unit": {
+      "const": "records",
+      "type": "string"
+    },
+    "demographic_deltas": {
+      "items": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "guidance": {
+      "description": "Interpretation or recovery guidance for this result",
+      "type": "string"
+    },
+    "next_actions": {
+      "description": "Suggested next calls using returned IDs and available scopes. Not executed and not user consent.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "arguments": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "tool",
+          "arguments",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "overlap_count": {
+      "type": "number"
+    },
+    "overlap_pct": {
+      "type": "number"
+    },
+    "page_count": {
+      "description": "Number of objects on this page, not the organization total",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "population_input": {
+      "additionalProperties": {},
+      "description": "Population input used for the preview; IDs refer to their current saved definitions",
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "warnings": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "a_name",
+    "b_name",
+    "a_count",
+    "b_count",
+    "overlap_count",
+    "overlap_pct",
+    "demographic_deltas"
+  ],
+  "type": "object"
+}

First observedSep 24, 2026

TDQS

A4.5/5.0

Behavior5/5

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

Adds substantial behavior beyond the annotations: it names the error code emitted on ambiguous input, discloses that saved composition, exclusions, and record limits are preserved, and warns that empty optional distributions mean unavailable rather than zero, which prevents a real misinterpretation. It also states the auth requirement ('discovery' scope), which no annotation covers.

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 return shape, then tight constraint sentences with no filler. A couple of clauses are compressed to the point of being slightly cryptic (which 'optional distributions', what exactly is 'preserved'), 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?

For a nested, four-parameter tool with an output schema, it covers the risky parts: input shape exclusivity, legacy compatibility, scope requirement, and output metric definitions. Given readOnlyHint=false, a short note on whether anything is persisted or billed by this calculation would close the last gap.

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 100%, so the baseline is 3, but the description adds the critical "EXACTLY ONE of" mutual-exclusion rule that the flat JSON schema cannot express (no oneOf/anyOf at the side level) and the legacy a/b vs audience_id_a/b exclusivity. It does not clarify set_logic defaults or when to prefer filter_groups over filters, leaving some shape-selection meaning to the schema.

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: "Calculate the overlap between two audience criteria sets", and immediately names the outputs (overlap_count, overlap_pct, demographic_deltas). The two-sided framing inherently separates it from single-set siblings like discovery_count and from discovery_crosstab, so an agent can pick it without opening any schema.

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 invocation rules rather than vague context: each side accepts exactly one of five input shapes, more than one per side is rejected with AMBIGUOUS_INPUT, legacy audience_id_a/b are mutually exclusive with a/b, and 'discovery' scope is required. It does not explicitly contrast itself with discovery_count or discovery_crosstab, so the alternative-selection guidance is inferred rather than stated.

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

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