MCP tools
Validate structure rules
Validate an engine StructureState against the rules engine WITHOUT saving.
Tool name: validate-structure-rules.
Validate an engine StructureState against the rules engine WITHOUT saving. Returns whether it is representable and the derived distribution (sets x creatives x max-per-set) plus any issues. Always call before authoring/editing to confirm the distribution is real. Read-only.
When to use
Dry-run a candidate StructureState before author/edit so you never promise an impossible distribution.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
config | object | Yes | |
config.countMode | string | Yes | dynamic = use the real attached-creative count at apply; fixed = exactly n. One of dynamic, fixed. |
config.n | integer | Yes | creative count (for dynamic, a placeholder the engine substitutes at apply). Maximum 1000. |
config.adsets | string | Yes | fixed = exactly k sets; distributed = ceil(n/per) sets of per. One of fixed, distributed. |
config.k | integer | Yes | number of ad sets when adsets=fixed (clamped 1..20). Maximum 20. |
config.per | integer | Yes | creatives per set when adsets=distributed. Maximum 20. |
config.placement | string | Yes | fixed-adsets only: broadcast = every set gets every creative; split = partition. One of broadcast, split. |
config.splitMode | string | Yes | One of even, weighted, roundrobin. |
config.weights | number[] | null | Yes | At most 20 items. |
config.name | string | Yes | |
config.ops | object[] | null | Yes | fixed-N custom drag-drop ops: clone/move/remove/group/addset |
config.remainderPolicy | string | No | One of frontload, lastset, drop. |
config.minPerSet | integer | No | Minimum 0, maximum 50. |
config.maxPerSet | integer | No | Minimum 0, maximum 50. |
audiences | object[] | No | Template-level audiences (targetingSet | customAudience | savedAudience). At least one is required to save or apply. |
Output
The tool catalog does not declare an output schema for this tool.
REST equivalent
MCP only. No REST operation does the same thing.