Get member campaign responses
sm_get_member_campaignsRead-onlyIdempotent
List the individual campaigns one member received, opened or clicked. This email-level drill-down is often empty even for highly engaged members, so always keep a fallback. For the inverse view — the members who responded to one campaign — use sm_list_campaign_responders.
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>",
"subscriberHash": "<subscriberHash>"
},
"name": "sm_get_member_campaigns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters. | |
| dateTo | No | Inclusive ISO-8601 calendar date (UTC) upper bound for the time range in YYYY-MM-DD format. Omit to leave the end of the time window unbounded or use the endpoint's default. | |
| sortBy | No | The field used to order the member campaigns list. Defaults to the send time of the campaign. | send_time |
| sortDir | No | The direction to sort the campaign results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "desc" when omitted. | desc |
| dateFrom | No | Inclusive ISO-8601 calendar date (UTC) lower bound for the time range in YYYY-MM-DD format. Omit to leave the start of the time window unbounded. | |
| 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. | |
| 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. | |
| openedFilter | No | Filter timeline events to only those where the campaign was opened, not opened, or 'all' to ignore open status. Defaults to "all" when omitted. | all |
| clickedFilter | No | Filter timeline events to only those where the campaign was clicked, not clicked, or 'all' to ignore click status. Defaults to "all" when omitted. | all |
| maxTimeToOpen | No | Maximum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no upper bound. | |
| minTimeToOpen | No | Minimum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no lower bound. | |
| subjectFilter | No | Filter the timeline by a case-insensitive partial match on the campaign subject line. Omit to include all subjects. | |
| maxTimeToClick | No | Maximum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no upper bound. | |
| minTimeToClick | No | Minimum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no lower bound. | |
| subscriberHash | Yes | The member's Mailchimp-style lowercase MD5 subscriber hash (canonical member key). |
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. | |
| data | No | Response rows for the enclosing tool. | |
| 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. | |
| subscriberHash | No | The 32-character lowercase hex MD5 hash of the member's downcased email address. This is the canonical unique identifier for members exposed across the Enterprise API, identical to Mailchimp's core behavior. The API will never expose internal synthetic BigQuery UUIDs. |