Servers Playground How we check Add a server Log in

Space Monkey Mailchimp Dashboard

Working · 1.5 s

com.igods/space-monkeyv1.2.0 Domain verified

Mailchimp engagement intelligence for AI agents: campaign analytics and audience insights.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://spacemonkey.igods.com/_api/public/v1/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

sm_get_account Read-only

Introspect the API key's own account — effective tier, per-service entitlements, current hour/month quota usage and project count. Use it to check headroom or diagnose a 403/429 before retrying.

This tool takes no arguments.

Space Monkey Mailchimp Dashboard MCP server | mcptry

Tools (26)

sm_get_account

Introspect the API key's own account — effective tier, per-service entitlements, current hour/month quota usage and project count. Use it to check headroom or diagnose a 403/429 before retrying.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

sm_get_campaign

Load one campaign's full report — delivery, open, click, click-to-open and bounce rates plus campaign metadata. Use after you have identified a campaign of interest. Returns a fixed-size set of campaign-level aggregates in one call regardless of audience size; per-variant, funnel and geography breakdowns are on sm_get_variate, not here.

read-only

Argument	Type	Description
projectId*	string	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.
campaignId*	string	The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "campaignId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error."
    }
  },
  "additionalProperties": false
}

sm_get_campaign_post_mortem

Produce a full post-mortem of one sent campaign: summary metadata, delivery and performance rates, engagement velocity (time-to-first-open and hourly engagement), audience quality, and per-variant breakdown when the campaign is an A/B test. Combines the detail, velocity, audience-quality and variate views into one report. All metrics come from synced BigQuery tables, so they are only as current as the project last sync run.

read-only

Argument	Type	Description
botFilter	string	Filter out members whose interactions appear to be automated bot activity. Select 'suspected-bot' for only bots, 'clean' to exclude bots, or 'all' (default) to ignore.
projectId*	string	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.
campaignId*	string	The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "campaignId"
  ],
  "properties": {
    "botFilter": {
      "enum": [
        "all",
        "suspected-bot",
        "clean"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter out members whose interactions appear to be automated bot activity. Select 'suspected-bot' for only bots, 'clean' to exclude bots, or 'all' (default) to ignore."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "campaignId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]+$",
      "description": "The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error."
    }
  },
  "additionalProperties": false
}

sm_get_insights_advanced

Get deeper audience analytics for a project: engagement distribution, tag and segment summaries, subscriber-growth baseline with churn decomposition, and campaign consistency. Use when basic insights cannot explain a change. Excludes the per-campaign performance table, single-campaign detail, list overview and the engagement and send-volume trends — use sm_get_insights_basic for those. Excludes campaign fatigue, subject-line keywords, send-time heatmap, monthly trend and audience health — use sm_get_insights_expert. All three insight tiers also return campaign averages, previous-period averages, audience summary and auto-generated insights.

read-only

Argument	Type	Description
endDate	string	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.
projectId*	string	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.
startDate	string	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.
campaignId	string	The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error.

sm_get_insights_basic

Get headline campaign and audience performance for a project: per-campaign performance table, single-campaign detail, list overview, engagement and send-volume trends, subscriber-growth series, and period-over-period averages. Start here for "how are we doing". Excludes engagement distribution, tag and segment summaries, growth baseline/churn decomposition and campaign consistency — use sm_get_insights_advanced for those. Excludes campaign fatigue, subject-line keywords, send-time heatmap, monthly trend and audience health — use sm_get_insights_expert. For the member-composition view (status, rating, rep and language counts) use sm_get_member_overview, and for signup cohorts, churn and retention use sm_get_member_growth; the list overview and subscriber-growth series here are Mailchimp-list and audience-trend views, not member-level lifecycle. All three insight tiers also return campaign averages, previous-period averages, audience summary and auto-generated insights.

read-only

Argument	Type	Description
search	string	Filter the campaigns table section by a case-insensitive partial match on text or subject line. Note: this does not narrow the aggregate stats.
endDate	string	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.
projectId*	string	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.
startDate

sm_get_insights_expert

Get expert diagnostics explaining why performance is moving: campaign fatigue, subject-line keywords, timezone-aware send-time heatmap, monthly trend and audience health, plus engagement distribution and campaign consistency (also available from sm_get_insights_advanced). Use only after basic or advanced have established what changed. Excludes the per-campaign performance table, single-campaign detail, list overview and the engagement and send-volume trends — use sm_get_insights_basic. Excludes tag and segment summaries and the subscriber-growth series and baselines — use sm_get_insights_advanced. All three insight tiers also return campaign averages, previous-period averages, audience summary and auto-generated insights.

read-only

Argument	Type	Description
endDate	string	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.
projectId*	string	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.
startDate	string	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.
campaignId	string	The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error.

sm_get_knowledge

Returns Space Monkey's MCP knowledge documents (analyst preamble, metric guardrails, live OpenAPI schema URL) as tool output for clients that cannot read MCP resources — read this before interpreting any Space Monkey metrics.

read-only

Argument	Type	Description
topic	string	Optional short topic selector to fetch a single knowledge document (one of: analyst-preamble, metric-guardrails, openapi, faq). Omit this parameter to receive a compact topic index.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [],
  "properties": {
    "topic": {
      "enum": [
        "analyst-preamble",
        "metric-guardrails",
        "openapi",
        "faq"
      ],
      "type": "string",
      "description": "Optional short topic selector to fetch a single knowledge document (one of: analyst-preamble, metric-guardrails, openapi, faq). Omit this parameter to receive a compact topic index."
    }
  },
  "additionalProperties": false
}

sm_get_member

Load one member's full profile — title, company, tags, clicked URLs, engagement percentile, at-risk state and bot detection. Use for pre-call briefs and to enrich a shortlist.

read-only

Argument	Type	Description
projectId*	string	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.
subscriberHash*	string	The member's Mailchimp-style lowercase MD5 subscriber hash (canonical member key).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "subscriberHash"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "subscriberHash": {
      "type": "string",
      "pattern": "^[0-9a-f]{32}$",
      "description": "The member's Mailchimp-style lowercase MD5 subscriber hash (canonical member key)."
    }
  },
  "additionalProperties": false
}

sm_get_member_campaigns

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.

read-only

Argument	Type	Description
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
dateTo	string	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	string	The field used to order the member campaigns list. Defaults to the send time of the campaign.
sortDir	string	The direction to sort the campaign results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "desc" when omitted.
dateFrom	string	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	number	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.

sm_get_member_geo

Get the country and region distribution of a project's members. Use for territory, event and travel-planning questions. Country is inferred from the member's region where possible (US states and Canadian provinces map to US and CA) before falling back to stored country data, with unresolvable values bucketed as Unknown; regions stays null unless countryCode is passed.

read-only

Argument	Type	Description
projectId*	string	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.
countryCode	string	Two-letter ISO country code to drill into, matched case-insensitively (e.g. 'US', 'CA'). Omit it and `regions` comes back null while `countries` and `allRegions` still cover the whole audience; pass it and `regions` returns that country's region breakdown.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "countryCode": {
      "type": "string",
      "description": "Two-letter ISO country code to drill into, matched case-insensitively (e.g. 'US', 'CA'). Omit it and `regions` comes back null while `countries` and `allRegions` still cover the whole audience; pass it and `regions` returns that country's region breakdown."
    }
  },
  "additionalProperties": false
}

sm_get_member_growth

Get signup cohorts, churn timeline and cohort retention. Use for list-growth and attrition questions. A cohortRetention row is the current status breakdown of members who signed up in that month, not retention at month N after signup; signup month falls back to last-changed or sync time when Mailchimp has no opt-in timestamp. For the audience size trend over time — subscriber counts bucketed by status month over month — use the subscriber-growth series in sm_get_insights_basic; this returns signup cohorts, churn and retention rather than a status trend.

read-only

Argument	Type	Description
projectId*	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false
}

sm_get_member_overview

Get aggregate audience composition for a project — totals plus status, rating, rep and language breakdowns. Use for a quick shape-of-the-list answer. Not paginated: totals and the status and rating breakdowns cover every member, but the language list is truncated to the top 20 and the rep and custom-dimension lists to the top 25, and the rep block is absent unless the project maps an owner merge field. For Mailchimp-list health — per-audience sizes, unsubscribe and cleaned counts, open and click rates — use the list overview in sm_get_insights_basic; this tool is the member-composition view (status, rating, rep, language) instead.

read-only

Argument	Type	Description
projectId*	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false
}

sm_get_member_segments

Get tags and segments with their engagement and status breakdowns. Use to turn an event or interest tag into a working audience. Every tag and segment is returned in one unpaginated call, but untagged members are excluded from the tag list and surface only as a separate untaggedCount, and tag engagement rates exclude insiders while tag member counts do not.

read-only

Argument	Type	Description
projectId*	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false
}

sm_get_member_timeline

Replay one member's raw activity events in time order. Use to establish when someone last paid attention and what triggered it.

read-only

Argument	Type	Description
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
dateTo	string	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	string	The field used to order the timeline. Defaults to ordering by the most recent timestamp first.
sortDir	string	The direction to sort the timeline results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "desc" when omitted.
dateFrom	string	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	number	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*

sm_get_prompt

Render one Space Monkey prompt workflow with concrete argument values, returning the complete instruction text ready to follow, plus the effective arguments that were bound (provided values plus defaults for omitted optionals). Prompt names and their arguments come from sm_list_prompts. If the rendered text still contains {{tokens}} such as {{projectId}} or {{company}}, a required argument was not provided; call again with it filled. The rendered text references sm_ tools by name; call them as instructed.

read-only

Argument	Type	Description
name*	string	Prompt name from sm_list_prompts, e.g. sm_brief_before_call.
arguments	object	Argument values for the prompt, keyed by argument name (e.g. {"company": "Conversion Sciences", "email": "[email protected]"}). Omit optional arguments to use their defaults. Multi-line values are supported.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Prompt name from sm_list_prompts, e.g. sm_brief_before_call."
    },
    "arguments": {
      "type": "object",
      "description": "Argument values for the prompt, keyed by argument name (e.g. {\"company\": \"Conversion Sciences\", \"email\": \"[email protected]\"}). Omit optional arguments to use their defaults. Multi-line values are supported.",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}

sm_get_schema

Get the Enterprise API's OpenAPI-derived schema catalog. Omitting `operation` returns a compact index of every Enterprise API operation; passing a tool name, full path, or path suffix returns that one operation's full parameters and resolved response schemas. Use before calling an unfamiliar tool to confirm its exact fields.

read-only

Argument	Type	Description
operation	string	Optional selector for one Enterprise API operation. Omit this parameter to receive a compact index of every Enterprise API operation. Pass a tool name (e.g. sm_list_leaders), a full path (e.g. /_api/public/v1/enterprise/members/detail), or a path suffix (e.g. members/detail) to receive that operation's full parameters and resolved response schemas.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [],
  "properties": {
    "operation": {
      "type": "string",
      "description": "Optional selector for one Enterprise API operation. Omit this parameter to receive a compact index of every Enterprise API operation. Pass a tool name (e.g. sm_list_leaders), a full path (e.g. /_api/public/v1/enterprise/members/detail), or a path suffix (e.g. members/detail) to receive that operation's full parameters and resolved response schemas."
    }
  },
  "additionalProperties": false
}

sm_get_sync_run

Load one sync run's full detail — per-stage results, progress, lookback window and pending batch count. Use after sm_list_sync_runs to explain why data is stale or a run failed. Failure detail lands in one of two places and rarely both: orchestration failures set run.errorMessage with no stage rows, while per-data-type failures leave it null and record the message on results[].errorMessage, so check both and treat status as the failure signal.

read-only

Argument	Type	Description
runId*	string	The opaque 8-character hash ID correlating to the sync run.
projectId*	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "runId"
  ],
  "properties": {
    "runId": {
      "type": "string",
      "description": "The opaque 8-character hash ID correlating to the sync run."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false
}

sm_get_variate

Analyse a variate (A/B) campaign — per-variant reports, statistical significance, engagement velocity, audience quality and geo split. Only meaningful for multivariate campaigns. All metrics come from synced BigQuery tables rather than a live Mailchimp read, so they are only as current as the project's last sync run, whose cadence is per-project: manual, daily or weekly.

read-only

Argument	Type	Description
projectId*	string	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.
campaignId*	string	The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "campaignId"
  ],
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "campaignId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]+$",
      "description": "The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error."
    }
  },
  "additionalProperties": false
}

sm_list_at_risk

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.

read-only

Argument	Type	Description
rep	string	Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep.
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
search	string	Filter subscribers by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering.
sortBy	string	The field used to order the at-risk subscribers list. Defaults to the number of recent active actions.
sortDir	string	The direction to sort the at-risk results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "asc" when omitted.
maxPrior	number	Maximum count of engagement actions prior to the recent drop-off. Omit to impose no upper bound.
minPrior	number	Minimum count of engagement actions prior to the recent drop-off. Omit to impose no lower bound.

sm_list_campaign_responders

List the members who registered a tracked response to one campaign — opened, clicked, bounced or unsubscribed — never the full send list; emailsSent is echoed so the unenumerated majority stays visible as a denominator. Narrow with action (clicked-only is usually a fraction of responders), engagementType, variant, rating or score filters; subscriberHash is the MD5 of the downcased email and joins to member-centric tools. For the campaign's own report use sm_get_campaign, for member-to-campaign history use sm_get_member_campaigns (the inverse view), and for the whole directory use sm_list_members. Results are paginated with an opaque keyset cursor valid for 24 hours and pageSize capped at 100 rows.

read-only

Argument	Type	Description
action	string	Narrow rows to one tracked response: all (default), opened, clicked, bounced or unsubscribed. action=clicked asks whether a member ever clicked, regardless of anything else they did. Clicked-only is usually a fraction of the responder set, so use it before paging through everything.
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Valid for 24 hours from issuance and bound to the exact query parameters used to generate it — it is not signed, just scoped; changing any filter, sort field, or sort direction while paginating causes the request to fail with a CURSOR_QUERY_MISMATCH error rather than silently re-scoping the results.
leader	string	Filter responders to include only recognized leaders ('true'), exclude leaders ('false'), or ignore leader status ('all', default).
region	string

sm_list_campaigns

List a project's campaigns with performance metrics. Use to map a member's lastActivityAt onto a real send, or to find the latest house send by send_time.

read-only

Argument	Type	Description
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
search	string	Filter campaigns by a case-insensitive partial match on the subject line or specific internal campaign IDs. Omit to skip text filtering.
sortBy	string	The field used to order the campaigns list. Defaults to sorting by the most recent send time first.
endDate	string	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.
sortDir	string	The direction to sort the campaign results. Can be 'asc' for ascending or 'desc' for descending. Defaults to "desc" when omitted.
pageSize	integer	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*

sm_list_leaders

Rank the most engaged members of a project by engagement percentile. Use when you need who is paying attention right now, filtered by rep, tag, rating, status or bot/insider rules. engagementScore is a 0-100 percentile here (at-risk tools use a raw score that can go negative), memberRating is Mailchimp's 1-5 rating, and subscriberHash is the MD5 of the member's downcased email, the join key for member-centric tools. Results are paginated with pageSize capped at 100 rows.

read-only

Argument	Type	Description
rep	string	Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep.
tag	string	Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags.
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
search	string	Filter leaders by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering.
sortBy	string	The field used to order the leaderboard results. Defaults to sorting by the highest engagement score first.
status	string	Filter members by their specific leader status (e.g. VIP or standard leader). Select 'all' to include every status. Defaults to "all" when omitted.

sm_list_members

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.

read-only

Argument	Type	Description
rep	string	Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep.
tag	string	Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags.
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
leader	string	Filter the directory to include only recognized leaders ('true'), exclude leaders ('false'), or ignore leader status ('all'). Defaults to "all" when omitted.
region	string	Filter members by their exact region or state name as recognized by Mailchimp geography data. Omit to include all regions.
search	string	Filter the directory by a case-insensitive partial match on email address, first name, or last name. Omit to skip text filtering.
sortBy	string	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.

sm_list_projects

Resolve which Space Monkey projects this API key can read. Call this first when the user names a company rather than a project ID, and match on companyName — never silently mix projects.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

sm_list_prompts

List the Space Monkey prompt workflows: user-invocable recipes that chain sm_ tools into this week's sales actions (build call sheets, strike after a send, save cooling leaders, harvest an event, brief before a call). Each entry lists its arguments and its category. Use sm_get_prompt to render one with concrete argument values, then follow the rendered instructions to run the workflow.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

sm_list_sync_runs

List recent data-pipeline sync runs with status and results. Operational tool for checking data freshness before trusting an analysis. Results are paginated with pageSize capped at 100 rows.

read-only

Argument	Type	Description
cursor	string	Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters.
pageSize	number	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*	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "pageSize": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "search": {
      "type": "string",
      "maxLength": 200,
      "description": "Filter the campaigns table section by a case-insensitive partial match on text or subject line. Note: this does not narrow the aggregate stats."
    },
    "endDate": {
      "type": "string",
      "description": "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."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "startDate": {
      "type": "string",
      "description": "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."
    },
    "campaignId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]+$",
      "description": "The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error."
    },
    "maxSendVolume": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum number of emails sent to include a campaign in the insights aggregations. Omit to impose no upper bound."
    },
    "minSendVolume": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum number of emails sent to include a campaign in the insights aggregations. Omit to use the system default threshold."
    },
    "campaignSortBy": {
      "enum": [
        "subject_line",
        "send_time",
        "emails_sent",
        "open_rate",
        "click_rate"
      ],
      "type": "string",
      "default": "send_time",
      "description": "The field used to order the campaigns table within the insights payload. Defaults to sorting by send time."
    },
    "campaignSortDirection": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the campaigns table within the insights payload. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "subscriberHash"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "dateTo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "enum": [
        "subject_line",
        "send_time",
        "did_open",
        "did_click",
        "first_open_minutes",
        "first_click_minutes",
        "campaign_open_rate",
        "campaign_click_rate"
      ],
      "type": "string",
      "default": "send_time",
      "description": "The field used to order the member campaigns list. Defaults to the send time of the campaign."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the campaign results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    },
    "dateFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "minLength": 1,
      "description": "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": {
      "enum": [
        "all",
        "opened",
        "not_opened"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter timeline events to only those where the campaign was opened, not opened, or 'all' to ignore open status. Defaults to \"all\" when omitted."
    },
    "clickedFilter": {
      "enum": [
        "all",
        "clicked",
        "not_clicked"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter timeline events to only those where the campaign was clicked, not clicked, or 'all' to ignore click status. Defaults to \"all\" when omitted."
    },
    "maxTimeToOpen": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no upper bound."
    },
    "minTimeToOpen": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no lower bound."
    },
    "subjectFilter": {
      "type": "string",
      "description": "Filter the timeline by a case-insensitive partial match on the campaign subject line. Omit to include all subjects."
    },
    "maxTimeToClick": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no upper bound."
    },
    "minTimeToClick": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no lower bound."
    },
    "subscriberHash": {
      "type": "string",
      "pattern": "^[0-9a-f]{32}$",
      "description": "The member's Mailchimp-style lowercase MD5 subscriber hash (canonical member key)."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "subscriberHash"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "dateTo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "enum": [
        "timestamp",
        "activity_type",
        "campaign_title"
      ],
      "type": "string",
      "default": "timestamp",
      "description": "The field used to order the timeline. Defaults to ordering by the most recent timestamp first."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the timeline results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    },
    "dateFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "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": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "minLength": 1,
      "description": "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": {
      "enum": [
        "all",
        "opened",
        "not_opened"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter timeline events to only those where the campaign was opened, not opened, or 'all' to ignore open status. Defaults to \"all\" when omitted."
    },
    "clickedFilter": {
      "enum": [
        "all",
        "clicked",
        "not_clicked"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter timeline events to only those where the campaign was clicked, not clicked, or 'all' to ignore click status. Defaults to \"all\" when omitted."
    },
    "maxTimeToOpen": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no upper bound."
    },
    "minTimeToOpen": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum elapsed time from the campaign send until the member's first open, in minutes. Omit to impose no lower bound."
    },
    "subjectFilter": {
      "type": "string",
      "description": "Filter the timeline by a case-insensitive partial match on the campaign subject line. Omit to include all subjects."
    },
    "maxTimeToClick": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no upper bound."
    },
    "minTimeToClick": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum elapsed time from the campaign send until the member's first click, in minutes. Omit to impose no lower bound."
    },
    "subscriberHash": {
      "type": "string",
      "pattern": "^[0-9a-f]{32}$",
      "description": "The member's Mailchimp-style lowercase MD5 subscriber hash (canonical member key)."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "rep": {
      "type": "string",
      "description": "Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "search": {
      "type": "string",
      "description": "Filter subscribers by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering."
    },
    "sortBy": {
      "enum": [
        "active_actions_recent",
        "active_actions_prior",
        "email_address",
        "member_rating"
      ],
      "type": "string",
      "default": "active_actions_recent",
      "description": "The field used to order the at-risk subscribers list. Defaults to the number of recent active actions."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "asc",
      "description": "The direction to sort the at-risk results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"asc\" when omitted."
    },
    "maxPrior": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum count of engagement actions prior to the recent drop-off. Omit to impose no upper bound."
    },
    "minPrior": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum count of engagement actions prior to the recent drop-off. Omit to impose no lower bound."
    },
    "pageSize": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "enum": [
        "all",
        "suspected-bot",
        "clean"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    },
    "maxRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "minRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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": {
      "enum": [
        "all",
        "exclude",
        "only"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId",
    "campaignId"
  ],
  "properties": {
    "action": {
      "enum": [
        "all",
        "opened",
        "clicked",
        "bounced",
        "unsubscribed"
      ],
      "type": "string",
      "default": "all",
      "description": "Narrow rows to one tracked response: all (default), opened, clicked, bounced or unsubscribed. action=clicked asks whether a member ever clicked, regardless of anything else they did. Clicked-only is usually a fraction of the responder set, so use it before paging through everything."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Valid for 24 hours from issuance and bound to the exact query parameters used to generate it — it is not signed, just scoped; changing any filter, sort field, or sort direction while paginating causes the request to fail with a CURSOR_QUERY_MISMATCH error rather than silently re-scoping the results."
    },
    "leader": {
      "enum": [
        "all",
        "true",
        "false"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter responders to include only recognized leaders ('true'), exclude leaders ('false'), or ignore leader status ('all', default)."
    },
    "region": {
      "type": "string",
      "description": "Filter responders by their exact region or state name as recognized by Mailchimp geography data. Omit to include all regions."
    },
    "search": {
      "type": "string",
      "description": "Filter responders by a case-insensitive partial match on email address, first name, or last name. Omit to skip text filtering."
    },
    "sortBy": {
      "enum": [
        "email_address",
        "last_name",
        "open_count",
        "click_count",
        "engagement_score",
        "member_rating",
        "variant_label",
        "engagement_type"
      ],
      "type": "string",
      "default": "engagement_type",
      "description": "The field used to order the responder results. Each value is the snake_case spelling of the matching response field: email_address, last_name, open_count, click_count, engagement_score, member_rating, variant_label, or engagement_type. Defaults to sorting by engagement_type."
    },
    "country": {
      "type": "string",
      "description": "Filter responders by their exact two-letter ISO country code (e.g. 'US', 'GB'). Omit to include all countries."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the responder results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    },
    "variant": {
      "type": "string",
      "description": "Filter responders by an exact match on the campaign variant label (e.g. 'A', 'B', or 'Campaign' for non-variate campaigns). Omit to include responders across all variants."
    },
    "maxOpens": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum number of opens (open_count) allowed to include the responder in results. Omit for no maximum."
    },
    "maxScore": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Inclusive upper bound (0-100) on the member's overall engagement percentile score (engagementScore). Identical in meaning to the leaderboard's leaderMaxScore. Omit for no maximum."
    },
    "minOpens": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum number of opens (open_count) required to include the responder in results. Omit for no minimum."
    },
    "minScore": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Inclusive lower bound (0-100) on the member's overall engagement percentile score (engagementScore). Identical in meaning to the leaderboard's leaderMinScore. Omit for no minimum."
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "enum": [
        "all",
        "suspected-bot",
        "clean"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter out responders whose interactions appear to be automated bot activity. Select 'suspected-bot' for only bots, 'clean' to exclude bots, or 'all' (default) to ignore."
    },
    "maxClicks": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum number of clicks (click_count) allowed to include the responder in results. Omit for no maximum."
    },
    "maxRating": {
      "type": "number",
      "maximum": 5,
      "minimum": 1,
      "description": "Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "minClicks": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum number of clicks (click_count) required to include the responder in results. Omit for no minimum."
    },
    "minRating": {
      "type": "number",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "campaignId": {
      "type": "string",
      "minLength": 1,
      "description": "The opaque string identifier for the campaign as assigned by Mailchimp. List campaigns to obtain this ID. If the ID is invalid or does not exist in the project, the endpoint will return a 404 error."
    },
    "insiderFilter": {
      "enum": [
        "all",
        "exclude",
        "only"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter out responders with internal company email domains or recognized insider addresses. Select 'exclude' to hide them, 'only' to show only them. Defaults to 'all', which applies no insider filtering."
    },
    "engagementType": {
      "enum": [
        "all",
        "open",
        "click"
      ],
      "type": "string",
      "default": "all",
      "description": "Grade each responder by their highest engagement: click if clickCount is above zero, otherwise open; all (default) applies no grading. Where action=clicked asks whether a member ever clicked, engagementType=open asks whether clicking was their highest form of engagement — the two filters answer different questions."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "search": {
      "type": "string",
      "description": "Filter campaigns by a case-insensitive partial match on the subject line or specific internal campaign IDs. Omit to skip text filtering."
    },
    "sortBy": {
      "enum": [
        "subject_line",
        "send_time",
        "emails_sent",
        "open_rate",
        "click_rate",
        "campaign_id"
      ],
      "type": "string",
      "default": "send_time",
      "description": "The field used to order the campaigns list. Defaults to sorting by the most recent send time first."
    },
    "endDate": {
      "type": "string",
      "description": "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."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the campaign results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "startDate": {
      "type": "string",
      "description": "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."
    },
    "maxSendVolume": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum number of emails sent to include the campaign in the results. Omit to impose no upper bound."
    },
    "minSendVolume": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum number of emails sent to include the campaign in the results. Omit to use the system default threshold."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "rep": {
      "type": "string",
      "description": "Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep."
    },
    "tag": {
      "type": "string",
      "description": "Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "search": {
      "type": "string",
      "description": "Filter leaders by a case-insensitive partial match on their email address, first name, or last name. Omit to skip text filtering."
    },
    "sortBy": {
      "enum": [
        "engagement_score",
        "total_opens",
        "total_clicks",
        "last_activity_at",
        "is_leader",
        "member_rating",
        "rep_name",
        "email_address"
      ],
      "type": "string",
      "default": "engagement_score",
      "description": "The field used to order the leaderboard results. Defaults to sorting by the highest engagement score first."
    },
    "status": {
      "enum": [
        "all",
        "vip",
        "non-vip",
        "leader"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter members by their specific leader status (e.g. VIP or standard leader). Select 'all' to include every status. Defaults to \"all\" when omitted."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "The direction to sort the leaderboard results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"desc\" when omitted."
    },
    "maxScore": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum engagement score percentile to include. The score ranges from 0 to 100. Omit to impose no maximum bound."
    },
    "minScore": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum engagement score percentile to include. The score ranges from 0 to 100. Omit to impose no minimum bound."
    },
    "pageSize": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "enum": [
        "all",
        "suspected-bot",
        "clean"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    },
    "maxRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "minRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "leaderOnly": {
      "type": "boolean",
      "default": true,
      "description": "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."
    },
    "insiderFilter": {
      "enum": [
        "all",
        "exclude",
        "only"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "projectId"
  ],
  "properties": {
    "rep": {
      "type": "string",
      "description": "Filter by an exact match on the assigned sales representative's name. Omit to include members assigned to any rep."
    },
    "tag": {
      "type": "string",
      "description": "Filter by an exact match on a Mailchimp tag or segment name. Omit to include members with any tags."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque keyset pagination cursor returned as `nextCursor` by the previous page. Must be replayed with identical query filters."
    },
    "leader": {
      "enum": [
        "all",
        "true",
        "false"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter the directory to include only recognized leaders ('true'), exclude leaders ('false'), or ignore leader status ('all'). Defaults to \"all\" when omitted."
    },
    "region": {
      "type": "string",
      "description": "Filter members by their exact region or state name as recognized by Mailchimp geography data. Omit to include all regions."
    },
    "search": {
      "type": "string",
      "description": "Filter the directory by a case-insensitive partial match on email address, first name, or last name. Omit to skip text filtering."
    },
    "sortBy": {
      "enum": [
        "email",
        "name",
        "status",
        "rating",
        "leader",
        "company",
        "rep",
        "tags",
        "signup",
        "lastChanged",
        "lastActivity",
        "dimension_one",
        "dimension_two",
        "dimension_three",
        "dimension_four",
        "email_address",
        "member_rating",
        "is_leader",
        "company_name",
        "rep_name",
        "timestamp_opt",
        "last_changed",
        "last_activity"
      ],
      "type": "string",
      "default": "email",
      "description": "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": {
      "enum": [
        "all",
        "subscribed",
        "unsubscribed",
        "cleaned"
      ],
      "type": "string",
      "default": "all",
      "description": "Filter members by their current Mailchimp subscription status. Use 'subscribed', 'unsubscribed', 'cleaned', or 'all' to include everyone. Defaults to \"all\" when omitted."
    },
    "country": {
      "type": "string",
      "description": "Filter members by their exact two-letter ISO country code (e.g. 'US', 'GB'). Omit to include all countries."
    },
    "sortDir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "asc",
      "description": "The direction to sort the directory results. Can be 'asc' for ascending or 'desc' for descending. Defaults to \"asc\" when omitted."
    },
    "pageSize": {
      "type": "number",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "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": {
      "enum": [
        "all",
        "suspected-bot",
        "clean"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    },
    "maxRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Maximum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "minRating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum Mailchimp member star rating to include, from 1 to 5. Omit to include every rating."
    },
    "projectId": {
      "type": "string",
      "minLength": 1,
      "description": "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": {
      "type": "string",
      "description": "Filter members by an exact match on custom dimension one. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip."
    },
    "dimensionTwo": {
      "type": "string",
      "description": "Filter members by an exact match on custom dimension two. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip."
    },
    "dimensionFour": {
      "type": "string",
      "description": "Filter members by an exact match on custom dimension four. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip."
    },
    "insiderFilter": {
      "enum": [
        "all",
        "exclude",
        "only"
      ],
      "type": "string",
      "default": "all",
      "description": "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."
    },
    "dimensionThree": {
      "type": "string",
      "description": "Filter members by an exact match on custom dimension three. Dimension values are derived from mapped Mailchimp merge fields. Omit to skip."
    }
  },
  "additionalProperties": false
}