Previous value: -"Output for the sm_list_leaders tool. Failure payloads arrive in the same envelope as { error, message, code }."New value: +"Output for the sm_list_leaders tool. Failure payloads arrive in the same envelope as { error, code }."

Added value: +"Leaderboard tier buckets from highest to lowest engagement."

Added value: +"Mean engagement score in the tier."

Added value: +"Mean member rating in the enclosing bucket."

Added value: +"Leaders in the tier."

Added value: +"Members in the tier."

Added value: +"Tier label, for example top, core, or watch."

Added value: +"Ordinal position of the tier for stable sorting."

Added value: +"Leader member rows ranked by engagement."

Added value: +"The member's email address."

Added value: +"Composite engagement score for the leader. Note: This is a 0-100 percentile."

Added value: +"The member's first name, or null when unavailable."

Added value: +"True when the member qualifies as a leader by engagement."

Added value: +"The member's last name, or null when unavailable."

Added value: +"Integer Mailchimp engagement rating for the member (1-5), or null when unrated."

Added value: +"Subscription status of the leader, or null."

Added value: +"Opaque 32-hex-character per-member identifier (MD5 of the lowercased/trimmed email address). It is deterministic and stable across calls, making it safe as a global join key when correlating a member across tools, though it will change if the member changes email address."

Added value: +"Total click events, counting repeat clicks."

Added value: +"Total open events, counting repeat opens by the same member."

Added value: +"True when the member is flagged VIP."

Added value: +"Distinct rep values available for filtering."

Added value: +"Leaders assigned to the rep."

Added value: +"Rep name."

Added value: +"Leaders currently active."

Added value: +"Leaders also flagged at risk."

Added value: +"Leaders flagged at risk."

Added value: +"Mean rating among leaders."

Added value: +"Mean member rating among leaders. Note: This is average member rating, not a mean engagement score."

Added value: +"Leaders with recent activity."

Added value: +"Total leaders in the audience."

Added value: +"Distinct tag values available for filtering."

Added value: +"Leaders carrying the tag."

Added value: +"Tag name."

Added value: +"Filter out members whose interactions appear to be automated bot activity. Select 'suspected-bot' for only bots, 'clean' to exclude bots, or 'all' to ignore. Defaults to \"all\" when omitted."

Added value: +"Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."

Added value: +"Filter out members with internal company email domains or recognized insider addresses. Select 'exclude' to hide them, 'only' to show only them, or 'all' to ignore. Defaults to \"all\" when omitted."

Added value: +"Restrict the leaderboard strictly to members recognized as highly engaged leaders. Set to false to include the broader audience in the engagement rank. Defaults to true when omitted."

Added value: +"Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."

Added value: +"Maximum engagement score percentile to include. The score ranges from 0 to 100. Omit to impose no maximum bound."

Added value: +"Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."

Added value: +"Minimum engagement score percentile to include. The score ranges from 0 to 100. Omit to impose no minimum bound."

Added value: +"Maximum number of rows to return per page. Omit to use the default page size of 100. MCP tool calls are capped at 100 rows per page to protect the model's context window."

Added value: +"Required. The opaque alphanumeric project identifier of 8 or more characters to scope this request to. Call GET /_api/public/v1/enterprise/projects to list the project IDs available to your API key. Omitting it returns 400 VALIDATION_ERROR."

Added value: +"Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep."

Added value: +"Filter leaders by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering."

Added value: +"The field used to order the leaderboard results. Defaults to sorting by the highest engagement score first."

Added value: +"The direction to sort the leaderboard results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."

Added value: +"Filter members by their specific leader status (e.g. VIP or standard leader). Select 'all' to include every status. Defaults to \"all\" when omitted."

Added value: +"Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Output for the sm_list_leaders tool. Failure payloads arrive in the same envelope as { error, message, code }.",
+  "properties": {
+    "code": {
+      "description": "A machine-readable identifier for the error type. For the full code taxonomy, see the sm_get_schema tool or the Enterprise API OpenAPI ErrorResponse component.",
+      "type": "string"
+    },
+    "error": {
+      "description": "A human-readable error message detailing what went wrong.",
+      "type": "string"
+    },
+    "hasMore": {
+      "description": "True if additional results exist beyond this page.",
+      "type": "boolean"
+    },
+    "leaderboardDistribution": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Distribution buckets for leaders across scoring tiers.",
+        "properties": {
+          "avgEngagementScore": {
+            "type": "number"
+          },
+          "avgMemberRating": {
+            "type": "number"
+          },
+          "leaderCount": {
+            "type": "integer"
+          },
+          "subscriberCount": {
+            "type": "integer"
+          },
+          "tier": {
+            "type": "string"
+          },
+          "tierOrder": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "leaders": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Represents an individual top-tier engaged member. Semantic conflict note: engagementScore here is a 0-100 percentile.",
+        "properties": {
+          "emailAddress": {
+            "type": "string"
+          },
+          "engagementScore": {
+            "type": "number"
+          },
+          "firstName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "isLeader": {
+            "type": "boolean"
+          },
+          "lastActivityAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "lastName": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "memberRating": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "repName": {
+            "description": "Null when owner merge field unmapped",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "subscriberHash": {
+            "type": "string"
+          },
+          "totalClicks": {
+            "type": "integer"
+          },
+          "totalOpens": {
+            "type": "integer"
+          },
+          "vip": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "nextCursor": {
+      "description": "A keyset cursor marking the continuation point. Contract: this value is non-null if and only if `hasMore` is true. Clients MUST echo this token verbatim on the subsequent request and MUST NEVER attempt to parse or manually construct it.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "pageSize": {
+      "description": "The maximum number of items returned in this page.",
+      "type": "integer"
+    },
+    "projectId": {
+      "description": "An opaque alphanumeric project identifier of 8 or more characters identifying a Space Monkey Project. Treat this value as entirely opaque; do not parse, sequentialize, or auto-generate it.",
+      "type": "string"
+    },
+    "repOptions": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Generic named-count tuple used for Rep and Tag options.",
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "summaryStats": {
+      "additionalProperties": true,
+      "description": "Overall summary stats for leaders. Note: avgScore is actually the average member RATING, preserved for now.",
+      "properties": {
+        "activeLeaderCount": {
+          "type": "integer"
+        },
+        "atRiskCount": {
+          "type": "integer"
+        },
+        "atRiskLeaderCount": {
+          "type": "integer"
+        },
+        "avgLeaderRating": {
+          "type": "number"
+        },
+        "avgScore": {
+          "type": "number"
+        },
+        "totalActive": {
+          "type": "integer"
+        },
+        "totalLeaders": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "tagOptions": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Generic named-count tuple used for Rep and Tag options.",
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}