Metadata MCP Connector

Estimate Target Group

estimate_target_group

Read-only

Estimate reach for LinkedIn or Reddit targeting criteria, including audience references and exclusions. Returns the match count and whether it falls below the channel minimum, or an error. This tool does not create a target group.

Input Schema

Name	Required	Description	Default
`channel`	Yes	Channel to estimate for. LINKEDIN (default) takes criteria ids from search_target_group_criteria; REDDIT takes them from search_reddit_criteria and is estimated the same way. Omit for LinkedIn.	LINKEDIN
`targeting`	No	Complete targeting configuration with include/exclude rules. Structure: { "include": [ { "criteria": [{"type": str, "data": object}], "audiences": [] } ], "exclude": {"criteria": [], "audiences": []} } All criteria IDs/references must come from search_target_group_criteria tool.

Schema Changelog

Changes observed during successful MCP inspections.

Changed14 schema fields changedOct 25, 2026

changedInput schema / properties / channel / description

Previous value: -"Channel to estimate for. LINKEDIN (default) takes criteria ids from search_target_group_criteria; REDDIT takes them from search_reddit_criteria and is estimated the same way (PRD-31759). Omit for LinkedIn."New value: +"Channel to estimate for. LINKEDIN (default) takes criteria ids from search_target_group_criteria; REDDIT takes them from search_reddit_criteria and is estimated the same way. Omit for LinkedIn."

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / properties

Added value: +{
+  "criteria": {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "externalId": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {
+                "countries": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                "states": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          ],
+          "description": "Channel criterion values returned by the criteria search tools."
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "data"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "inactive": {
+    "type": "boolean"
+  },
+  "matchCount": {
+    "type": [
+      "integer",
+      "null"
+    ]
+  },
+  "matchCountType": {
+    "type": "string"
+  },
+  "mdAudienceId": {
+    "minimum": 1,
+    "type": "integer"
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / required
```
Added value: +[
+  "mdAudienceId"
+]
```
addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / properties

Added value: +{
+  "data": {
+    "anyOf": [
+      {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "externalId": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      {
+        "additionalProperties": true,
+        "properties": {
+          "countries": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          },
+          "states": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    ],
+    "description": "Channel criterion values returned by the criteria search tools."
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / required
```
Added value: +[
+  "type",
+  "data"
+]
```
addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / properties

Added value: +{
+  "criteria": {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "externalId": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {
+                "countries": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                "states": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          ],
+          "description": "Channel criterion values returned by the criteria search tools."
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "data"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "inactive": {
+    "type": "boolean"
+  },
+  "matchCount": {
+    "type": [
+      "integer",
+      "null"
+    ]
+  },
+  "matchCountType": {
+    "type": "string"
+  },
+  "mdAudienceId": {
+    "minimum": 1,
+    "type": "integer"
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / required
```
Added value: +[
+  "mdAudienceId"
+]
```
addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / additionalProperties
```
Added value: +true
```

added

Input schema / properties / targeting / properties / include / items / properties / criteria / items / properties / data / anyOf

Added value: +[
+  {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "externalId": {
+          "type": [
+            "string",
+            "integer"
+          ]
+        },
+        "id": {
+          "type": [
+            "string",
+            "integer"
+          ]
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "countries": {
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      },
+      "states": {
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / properties / data / description
```
Added value: +"Channel criterion values returned by the criteria search tools."
```
addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / required
```
Added value: +[
+  "type",
+  "data"
+]
```

First observedSep 16, 2026

TDQS

A4.2/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds real value beyond them by disclosing the return shape: match count, whether it falls below the channel minimum, or an error. It stops short of saying whether estimates are exact/approximate or how errors are surfaced.

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

Conciseness5/5

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

Three short sentences, front-loaded with the primary action, then the return values, then the negative scoping. Every sentence carries distinct information with no repetition of the schema.

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?

Despite a deeply nested targeting object and no output schema, the description plus the 100%-covered schema and read-only annotations give an agent enough to call it correctly, and the return semantics are spelled out. The only omission is a pointer to the mandatory criteria search tools at the description level, which currently lives only inside 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?

Schema coverage is 100% and the channel property is richly documented (enum, default, which criteria search tool feeds each channel). The description's phrase 'including audience references and exclusions' alludes to the include.audiences and exclude fields but adds no format or sourcing detail beyond the schema. 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 specific verb and resource ('Estimate reach for LinkedIn or Reddit targeting criteria') and explicitly distinguishes itself from the creation tool with 'This tool does not create a target group.' An agent can separate this from create_target_group or retrieve_target_group_by_id 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?

The 'does not create a target group' clause implies the preview-before-create use case and rules out a sibling. However, it never states the positive condition (e.g., call this before create_target_group to validate reach) nor names an alternative to use when estimation is not wanted.

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

All Metadata MCP Connector 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?