skills/docs.clickmax.io/clickmax-list-segments

clickmax-list-segments

Installation
SKILL.md

As tools abaixo aparecem com os nomes que o MCP da Clickmax registra. Se o seu cliente de IA prefixar nomes de tool (mcp__<servidor>__, mcp_<servidor>_, ou outro), use o nome já prefixado que aparecer na sua lista de tools.

When this applies

Use this skill when the user wants manual list operations or dynamic segment logic: create/update/delete lists, manage list membership, build or replace segment filters, preview segment size, reload segments, or inspect list/segment leads.

Not this skill:

  • raw lead filtering without creating reusable grouping -> clickmax-leads
  • tag-based cohort labeling -> clickmax-tags

Key assumptions

  • manual lists and dynamic segments are different grouping models
  • segment updates also affect the synced backing list metadata and lead membership lifecycle
  • upserting segment filters replaces the full tree
  • segment filters are a FLAT ARRAY of {id, order, operator, field, negation, parentId?, value*} items, not nested objects — nesting comes from each item's parentId pointing at its parent GROUP item's own id; group items use field: 'children' + operator: 'childrenAnd'/'childrenOr'. Preserve every existing item (by id) when replacing, not just the branch being edited.
  • reload queues recomputation; it is not just a cosmetic refresh
  • Read filter model before building non-trivial segment logic.
Installs
92
First Seen
Jun 16, 2026
clickmax-list-segments from docs.clickmax.io