Space Monkey Mailchimp Dashboard

Get basic insights

sm_get_insights_basic

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`search`	No	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`	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.
`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.
`startDate`	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.
`campaignId`	No	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`	No	Maximum number of emails sent to include a campaign in the insights aggregations. Omit to impose no upper bound.
`minSendVolume`	No	Minimum number of emails sent to include a campaign in the insights aggregations. Omit to use the system default threshold.
`campaignSortBy`	No	The field used to order the campaigns table within the insights payload. Defaults to sorting by send time.	send_time
`campaignSortDirection`	No	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.	desc

Output Schema

TableJSON Schema

Name	Required	Description
`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.
`insights`	No	Auto-generated insight objects pairing a title with a descriptive sentence.
`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.
`listOverview`	No	Per-list overview: one row per Mailchimp audience with size and health metrics.
`campaignTotal`	No	Total campaigns in the period.
`campaignDetail`	No	Comprehensive details for a single campaign. May be null.
`audienceSummary`	No	Current audience status rollup: one row per member status with the member count.
`engagementTrend`	No	Month-over-month engagement trend rows.
`sendVolumeTrend`	No	Month-over-month send volume rows.
`campaignAverages`	No	Single summary row of aggregate campaign metrics for the current period.
`subscriberGrowth`	No	Audience growth rows over time, bucketed by member status.
`computedThreshold`	No	Threshold value computed for the current analysis, or null when not applicable.
`campaignPerformance`	No	Per-campaign performance rows for the period, with send, open, click, bounce and unsubscribe metrics.
`previousPeriodAverages`	No	Single summary row of aggregate campaign metrics for the prior comparison period.

Schema Changelog

Changes observed during successful MCP inspections.

Changed99 schema fields changedSep 11, 2026
- changedOutput schema / description
```
Previous value: -"Output for the sm_get_insights_basic tool. Failure payloads arrive in the same envelope as { error, message, code }."New value: +"Output for the sm_get_insights_basic tool. Failure payloads arrive in the same envelope as { error, code }."
```
- addedOutput schema / properties / audienceSummary / description
```
Added value: +"Current audience status rollup: one row per member status with the member count."
```
- addedOutput schema / properties / audienceSummary / items / properties / memberCount / description
```
Added value: +"Members in the status."
```
- addedOutput schema / properties / audienceSummary / items / properties / status / description
```
Added value: +"Subscription status."
```
- addedOutput schema / properties / campaignAverages / description
```
Added value: +"Single summary row of aggregate campaign metrics for the current period."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgBounceRate / description
```
Added value: +"Mean bounce rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgClickRate / description
```
Added value: +"Mean click rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgClickToOpenRate / description
```
Added value: +"Mean click-to-open rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgDeliveryRate / description
```
Added value: +"Mean delivery rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgEmailsSent / description
```
Added value: +"Mean emails sent per campaign in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / avgOpenRate / description
```
Added value: +"Mean open rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalAbuseReports / description
```
Added value: +"Total abuse reports across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalBounces / description
```
Added value: +"Hard plus soft bounces."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalCampaigns / description
```
Added value: +"Total number of campaigns the enclosing summary covers."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalClicks / description
```
Added value: +"Total click events, counting repeat clicks."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalEmailsSent / description
```
Added value: +"Total emails sent across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalForwards / description
```
Added value: +"Total forward events across the campaigns in the enclosing summary. Forwards are not a working metric and must never be used to rank, recommend, or brief."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalHardBounces / description
```
Added value: +"Total permanent bounce events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalOpens / description
```
Added value: +"Total open events, counting repeat opens by the same member."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalSoftBounces / description
```
Added value: +"Total temporary bounce events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignAverages / items / properties / totalUnsubscribes / description
```
Added value: +"Total unsubscribe events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / campaignDetail / properties / abuseReports / description
```
Added value: +"Abuse reports."
```
- addedOutput schema / properties / campaignDetail / properties / bounceRate / description
```
Added value: +"Bounce rate (0-100)."
```
- addedOutput schema / properties / campaignDetail / properties / campaignId / description
```
Added value: +"Campaign identifier."
```
- addedOutput schema / properties / campaignDetail / properties / campaignType / description
```
Added value: +"Mailchimp campaign type."
```
- addedOutput schema / properties / campaignDetail / properties / clickRate / description
```
Added value: +"Click rate (0-100)."
```
- addedOutput schema / properties / campaignDetail / properties / clickToOpenRate / description
```
Added value: +"Click-to-open rate (0-100)."
```
- addedOutput schema / properties / campaignDetail / properties / delivered / description
```
Added value: +"Emails delivered."
```
- addedOutput schema / properties / campaignDetail / properties / deliveryRate / description
```
Added value: +"Delivery rate (0-100)."
```
- addedOutput schema / properties / campaignDetail / properties / emailsSent / description
```
Added value: +"Emails sent."
```
- addedOutput schema / properties / campaignDetail / properties / forwardsCount / description
```
Added value: +"Number of forward events. Forwards are not a working metric and must never be used to rank, recommend, or brief."
```
- addedOutput schema / properties / campaignDetail / properties / hardBounces / description
```
Added value: +"Hard bounces."
```
- addedOutput schema / properties / campaignDetail / properties / listName / description
```
Added value: +"Audience name."
```
- addedOutput schema / properties / campaignDetail / properties / openRate / description
```
Added value: +"Open rate (0-100)."
```
- addedOutput schema / properties / campaignDetail / properties / previewText / description
```
Added value: +"Preview text."
```
- addedOutput schema / properties / campaignDetail / properties / softBounces / description
```
Added value: +"Soft bounces."
```
- addedOutput schema / properties / campaignDetail / properties / subjectLine / description
```
Added value: +"Campaign subject line."
```
- addedOutput schema / properties / campaignDetail / properties / totalClicks / description
```
Added value: +"Total click events."
```
- addedOutput schema / properties / campaignDetail / properties / totalOpens / description
```
Added value: +"Total open events."
```
- addedOutput schema / properties / campaignDetail / properties / uniqueClicks / description
```
Added value: +"Distinct clickers."
```
- addedOutput schema / properties / campaignDetail / properties / uniqueOpens / description
```
Added value: +"Distinct openers."
```
- addedOutput schema / properties / campaignDetail / properties / unsubscribes / description
```
Added value: +"Unsubscribes."
```
- addedOutput schema / properties / campaignPerformance / description
```
Added value: +"Per-campaign performance rows for the period, with send, open, click, bounce and unsubscribe metrics."
```
- addedOutput schema / properties / campaignPerformance / items / properties / bounceRate / description
```
Added value: +"Bounces divided by emails sent, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / campaignId / description
```
Added value: +"Campaign identifier."
```
- addedOutput schema / properties / campaignPerformance / items / properties / clickRate / description
```
Added value: +"Unique clicks divided by delivered, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / clickToOpenRate / description
```
Added value: +"Unique clicks divided by unique opens, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / clicksTotal / description
```
Added value: +"Total click events, counting repeat clicks."
```
- addedOutput schema / properties / campaignPerformance / items / properties / deliveries / description
```
Added value: +"Number of emails accepted for delivery by the receiving mail system."
```
- addedOutput schema / properties / campaignPerformance / items / properties / deliveryRate / description
```
Added value: +"Delivered divided by emails sent, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / emailsSent / description
```
Added value: +"Number of emails the campaign attempted to send to recipients."
```
- addedOutput schema / properties / campaignPerformance / items / properties / openRate / description
```
Added value: +"Unique opens divided by delivered, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / opensTotal / description
```
Added value: +"Total open events, counting repeat opens by the same member."
```
- addedOutput schema / properties / campaignPerformance / items / properties / subjectLine / description
```
Added value: +"Campaign subject line."
```
- addedOutput schema / properties / campaignPerformance / items / properties / totalBounces / description
```
Added value: +"Hard plus soft bounces."
```
- addedOutput schema / properties / campaignPerformance / items / properties / uniqueClicks / description
```
Added value: +"Number of distinct members who clicked at least once."
```
- addedOutput schema / properties / campaignPerformance / items / properties / uniqueOpens / description
```
Added value: +"Number of distinct members who opened at least once."
```
- addedOutput schema / properties / campaignPerformance / items / properties / unsubscribeRate / description
```
Added value: +"Unsubscribes divided by delivered, as a percentage from 0 to 100."
```
- addedOutput schema / properties / campaignPerformance / items / properties / unsubscribed / description
```
Added value: +"Recipients who unsubscribed, when the enclosing row is per-campaign."
```
- addedOutput schema / properties / campaignTotal / description
```
Added value: +"Total campaigns in the period."
```
- addedOutput schema / properties / computedThreshold / description
```
Added value: +"Threshold value computed for the current analysis, or null when not applicable."
```
- addedOutput schema / properties / engagementTrend / description
```
Added value: +"Month-over-month engagement trend rows."
```
- addedOutput schema / properties / engagementTrend / items / properties / avgClickRate / description
```
Added value: +"Mean click rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / engagementTrend / items / properties / avgOpenRate / description
```
Added value: +"Mean open rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / engagementTrend / items / properties / campaignCount / description
```
Added value: +"Campaigns in the month."
```
- addedOutput schema / properties / insights / description
```
Added value: +"Auto-generated insight objects pairing a title with a descriptive sentence."
```
- addedOutput schema / properties / insights / items / properties / description / description
```
Added value: +"Insight explanation."
```
- addedOutput schema / properties / insights / items / properties / title / description
```
Added value: +"Insight title."
```
- addedOutput schema / properties / listOverview / description
```
Added value: +"Per-list overview: one row per Mailchimp audience with size and health metrics."
```
- addedOutput schema / properties / listOverview / items / properties / cleanedCount / description
```
Added value: +"Cleaned members in the audience."
```
- addedOutput schema / properties / listOverview / items / properties / clickRate / description
```
Added value: +"Unique clicks divided by delivered, as a percentage from 0 to 100."
```
- addedOutput schema / properties / listOverview / items / properties / memberCount / description
```
Added value: +"Members in the audience."
```
- addedOutput schema / properties / listOverview / items / properties / name / description
```
Added value: +"Audience name."
```
- addedOutput schema / properties / listOverview / items / properties / openRate / description
```
Added value: +"Unique opens divided by delivered, as a percentage from 0 to 100."
```
- addedOutput schema / properties / listOverview / items / properties / unsubscribeCount / description
```
Added value: +"Unsubscribed members in the audience."
```
- addedOutput schema / properties / previousPeriodAverages / description
```
Added value: +"Single summary row of aggregate campaign metrics for the prior comparison period."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgBounceRate / description
```
Added value: +"Mean bounce rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgClickRate / description
```
Added value: +"Mean click rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgClickToOpenRate / description
```
Added value: +"Mean click-to-open rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgDeliveryRate / description
```
Added value: +"Mean delivery rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgEmailsSent / description
```
Added value: +"Mean emails sent per campaign in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / avgOpenRate / description
```
Added value: +"Mean open rate across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalAbuseReports / description
```
Added value: +"Total abuse reports across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalBounces / description
```
Added value: +"Hard plus soft bounces."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalCampaigns / description
```
Added value: +"Total number of campaigns the enclosing summary covers."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalClicks / description
```
Added value: +"Total click events, counting repeat clicks."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalEmailsSent / description
```
Added value: +"Total emails sent across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalForwards / description
```
Added value: +"Total forward events across the campaigns in the enclosing summary. Forwards are not a working metric and must never be used to rank, recommend, or brief."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalHardBounces / description
```
Added value: +"Total permanent bounce events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalOpens / description
```
Added value: +"Total open events, counting repeat opens by the same member."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalSoftBounces / description
```
Added value: +"Total temporary bounce events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / previousPeriodAverages / items / properties / totalUnsubscribes / description
```
Added value: +"Total unsubscribe events across the campaigns in the enclosing summary."
```
- addedOutput schema / properties / sendVolumeTrend / description
```
Added value: +"Month-over-month send volume rows."
```
- addedOutput schema / properties / sendVolumeTrend / items / properties / campaignCount / description
```
Added value: +"Campaigns sent in the month."
```
- addedOutput schema / properties / sendVolumeTrend / items / properties / month / description
```
Added value: +"Year-month for the row."
```
- addedOutput schema / properties / sendVolumeTrend / items / properties / totalEmailsSent / description
```
Added value: +"Emails sent in the month."
```
- addedOutput schema / properties / subscriberGrowth / description
```
Added value: +"Audience growth rows over time, bucketed by member status."
```
- addedOutput schema / properties / subscriberGrowth / items / properties / memberCount / description
```
Added value: +"Members in the status."
```
- addedOutput schema / properties / subscriberGrowth / items / properties / status / description
```
Added value: +"Subscription status."
```

Changed10 schema fields changedSep 10, 2026

addedInput schema / properties / campaignId / description

Added value: +"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."

addedInput schema / properties / campaignSortBy / description

Added value: +"The field used to order the campaigns table within the insights payload. Defaults to sorting by send time."

addedInput schema / properties / campaignSortDirection / description

Added value: +"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."

addedInput schema / properties / endDate / description

Added value: +"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."

addedInput schema / properties / maxSendVolume / description

Added value: +"Maximum number of emails sent to include a campaign in the insights aggregations. Omit to impose no upper bound."

addedInput schema / properties / minSendVolume / description

Added value: +"Minimum number of emails sent to include a campaign in the insights aggregations. Omit to use the system default threshold."

addedInput schema / properties / projectId / description

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."

addedInput schema / properties / search / description

Added value: +"Filter the campaigns table section by a case-insensitive partial match on text or subject line. Note: this does not narrow the aggregate stats."

addedInput schema / properties / startDate / description

Added value: +"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."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Output for the sm_get_insights_basic tool. Failure payloads arrive in the same envelope as { error, message, code }.",
+  "properties": {
+    "audienceSummary": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Audience status summary counts.",
+        "properties": {
+          "memberCount": {
+            "type": "integer"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "campaignAverages": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Aggregated averages and totals across campaigns.",
+        "properties": {
+          "avgBounceRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgClickRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgClickToOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgDeliveryRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgEmailsSent": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "totalAbuseReports": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalCampaigns": {
+            "type": "integer"
+          },
+          "totalClicks": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalEmailsSent": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalForwards": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalHardBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalOpens": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalSoftBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalUnsubscribes": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "campaignDetail": {
+      "additionalProperties": true,
+      "description": "Comprehensive details for a single campaign. May be null.",
+      "properties": {
+        "abuseReports": {
+          "type": "integer"
+        },
+        "bounceRate": {
+          "type": "number"
+        },
+        "campaignId": {
+          "type": "string"
+        },
+        "campaignType": {
+          "type": "string"
+        },
+        "clickRate": {
+          "type": "number"
+        },
+        "clickToOpenRate": {
+          "type": "number"
+        },
+        "delivered": {
+          "type": "integer"
+        },
+        "deliveryRate": {
+          "type": "number"
+        },
+        "emailsSent": {
+          "type": "integer"
+        },
+        "forwardsCount": {
+          "type": "integer"
+        },
+        "hardBounces": {
+          "type": "integer"
+        },
+        "listName": {
+          "type": "string"
+        },
+        "openRate": {
+          "type": "number"
+        },
+        "previewText": {
+          "type": "string"
+        },
+        "sendTime": {
+          "description": "ISO 8601 UTC timestamp.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "softBounces": {
+          "type": "integer"
+        },
+        "subjectLine": {
+          "type": "string"
+        },
+        "totalClicks": {
+          "type": "integer"
+        },
+        "totalOpens": {
+          "type": "integer"
+        },
+        "uniqueClicks": {
+          "type": "integer"
+        },
+        "uniqueOpens": {
+          "type": "integer"
+        },
+        "unsubscribes": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "campaignPerformance": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Detailed performance for individual campaigns.",
+        "properties": {
+          "bounceRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "campaignId": {
+            "type": "string"
+          },
+          "clickRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "clickToOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "clicksTotal": {
+            "type": "integer"
+          },
+          "deliveries": {
+            "type": "integer"
+          },
+          "deliveryRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "emailsSent": {
+            "type": "integer"
+          },
+          "openRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "opensTotal": {
+            "type": "integer"
+          },
+          "sendTime": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "subjectLine": {
+            "type": "string"
+          },
+          "totalBounces": {
+            "type": "integer"
+          },
+          "uniqueClicks": {
+            "type": "integer"
+          },
+          "uniqueOpens": {
+            "type": "integer"
+          },
+          "unsubscribeRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "unsubscribed": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "campaignTotal": {
+      "type": "integer"
+    },
+    "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"
+    },
+    "computedThreshold": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "engagementTrend": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Monthly engagement trend data.",
+        "properties": {
+          "avgClickRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "campaignCount": {
+            "type": "integer"
+          },
+          "month": {
+            "description": "YYYY-MM bucket, never reformat",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "error": {
+      "description": "A human-readable error message detailing what went wrong.",
+      "type": "string"
+    },
+    "insights": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Automatically generated contextual insights.",
+        "properties": {
+          "campaignId": {
+            "description": "only emitted by the top-campaign insights",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "description": {
+            "type": "string"
+          },
+          "sentiment": {
+            "description": "one of positive/negative/neutral",
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "listOverview": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Top-level overview of an audience list.",
+        "properties": {
+          "cleanedCount": {
+            "type": "integer"
+          },
+          "clickRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "memberCount": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "openRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "unsubscribeCount": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "previousPeriodAverages": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Aggregated averages and totals across campaigns.",
+        "properties": {
+          "avgBounceRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgClickRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgClickToOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgDeliveryRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgEmailsSent": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "avgOpenRate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "totalAbuseReports": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalCampaigns": {
+            "type": "integer"
+          },
+          "totalClicks": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalEmailsSent": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalForwards": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalHardBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalOpens": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalSoftBounces": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "totalUnsubscribes": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "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"
+    },
+    "sendVolumeTrend": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Monthly send volume trend data.",
+        "properties": {
+          "campaignCount": {
+            "type": "integer"
+          },
+          "month": {
+            "type": "string"
+          },
+          "totalEmailsSent": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "subscriberGrowth": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Subscriber growth over time.",
+        "properties": {
+          "memberCount": {
+            "type": "integer"
+          },
+          "optDate": {
+            "description": "A BigQuery DATE, not a timestamp",
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

First observedSep 10, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnly, idempotent, open-world, and non-destructive behavior, and the description adds meaningful context beyond that. It discloses not only what the endpoint returns but also what it deliberately excludes, and it clarifies that the list/subscriber views are Mailchimp-level rather than member-level lifecycle, preventing semantic misinterpretation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every sentence earns its place: it front-loads the main purpose, then uses exclusion lists to steer the agent to the correct sibling tools. The final sentence about shared output across all three insight tiers prevents a misleading assumption that 'basic' lacks common aggregates.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity, the fully detailed input schema, the output schema, and the rich sibling set, the description is remarkably complete. It covers purpose, scope, exclusions, alternatives, and cross-tier behavior, leaving no major gap an agent would need to resolve by trial and error.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all nine parameters thoroughly. The description itself adds little parameter-level meaning beyond implying the project scope, but since the baseline is 3 for high schema coverage, no deduction is warranted.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Get headline campaign and audience performance for a project' and then enumerates concrete output sections. It also clearly distinguishes itself from sm_get_insights_advanced, sm_get_insights_expert, sm_get_member_overview, and sm_get_member_growth, so an agent can disambiguate it from nearby siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says 'Start here for "how are we doing"', which tells the agent when to select this tool. It also lists exactly which capabilities are excluded and explicitly names the alternative tool for each excluded category, giving clear when-to-use versus when-to-use-another guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Space Monkey Mailchimp Dashboard tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?