Browse member directory
sm_list_membersRead-onlyIdempotent
Browse or search a project's full member directory. Use when you need people by rating, tag, status or free-text search rather than by engagement rank.
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_members"
}
}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. | |
| tag | No | Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags. | |
| cursor | No | Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters. | |
| leader | No | Filter the directory to include only recognized leaders ('true'), exclude leaders ('false'), or ignore leader status ('all'). Defaults to "all" when omitted. | all |
| region | No | Filter members by their exact region or state name as recognized by Mailchimp geography data. Omit to include all regions. | |
| search | No | Filter the directory by a case-insensitive partial match on email address, first name, or last name. Omit to skip text filtering. | |
| sortBy | No | The field used to order the directory results. Defaults to sorting alphabetically by email address. The snake_case spellings matching response field names (email_address, member_rating, is_leader, company_name, rep_name, timestamp_opt, last_changed, last_activity, status, tags, dimension_one, dimension_two, dimension_three, dimension_four) are canonical. 'email', 'rating', 'leader', 'company', 'rep', 'signup', 'lastChanged', and 'lastActivity' are accepted deprecated aliases kept for backward compatibility and sort identically to their canonical equivalents. Sorting by company/company_name, rep/rep_name, or dimension_one..dimension_four falls back to ordering by email address when the corresponding merge field is unmapped. 'tags' sorts the raw underlying JSON string, not the string array returned in the response. 'name' is a composite sort across last name, first name, and company name and has no single corresponding response field. | |
| status | No | Filter members by their current Mailchimp subscription status. Use 'subscribed', 'unsubscribed', 'cleaned', or 'all' to include everyone. Defaults to "all" when omitted. | all |
| country | No | Filter members by their exact two-letter ISO country code (e.g. 'US', 'GB'). Omit to include all countries. | |
| sortDir | No | The direction to sort the directory results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "asc" when omitted. | asc |
| 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. | |
| dimensionOne | No | Filter members by an exact match on custom dimension one. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip. | |
| dimensionTwo | No | Filter members by an exact match on custom dimension two. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip. | |
| dimensionFour | No | Filter members by an exact match on custom dimension four. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip. | |
| 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 |
| dimensionThree | No | Filter members by an exact match on custom dimension three. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip. |
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. | |
| members | No | Member directory rows. | |
| 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. |