Find at-risk members
sm_list_at_riskRead-onlyIdempotent
Find previously engaged members whose recent activity has collapsed, for building save lists. Note its engagementScore is a raw decayed score that can be negative, unlike the leaders percentile.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "sm_list_at_risk"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rep | No | Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep. | |
| cursor | No | Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters. | |
| search | No | Filter subscribers by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering. | |
| sortBy | No | The field used to order the at-risk subscribers list. Defaults to the number of recent active actions. | active_actions_recent |
| sortDir | No | The direction to sort the at-risk results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "asc" when omitted. | asc |
| maxPrior | No | Maximum count of engagement actions prior to the recent drop-off. Omit to impose no upper bound. | |
| minPrior | No | Minimum count of engagement actions prior to the recent drop-off. Omit to impose no lower bound. | |
| pageSize | No | 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. | |
| botFilter | No | 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. | all |
| maxRating | No | Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating. | |
| minRating | No | Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating. | |
| projectId | Yes | 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. | |
| insiderFilter | No | 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. | all |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | 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. | |
| error | No | A human-readable error message detailing what went wrong. | |
| hasMore | No | True if additional results exist beyond this page. | |
| pageSize | No | The maximum number of items returned in this page. | |
| projectId | No | 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. | |
| nextCursor | No | 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. | |
| subscribers | No | At-risk member rows. | |
| distribution | No | Rating-bucket distribution of the at-risk population. | |
| quadrantData | No | Per-member rows for the prior-vs-recent activity quadrant. | |
| repBreakdown | No | Per-rep rollup of the at-risk population. |