Space Monkey Mailchimp Dashboard

Get advanced insights

sm_get_insights_advanced

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Description
`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.

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.
`tagSummary`	No	Tag summary rows.
`segmentSummary`	No	Segment summary rows.
`audienceSummary`	No	Current audience status rollup: one row per member status with the member count.
`campaignAverages`	No	Single summary row of aggregate campaign metrics for the current period.
`subscriberGrowth`	No	Audience growth rows over time, bucketed by member status.
`campaignDateRange`	No	Overall chronological range of campaigns. May be null.
`computedThreshold`	No	Threshold computed for the analysis, or null when not applicable.
`campaignConsistency`	No	Statistical consistency metrics for campaign performance. May be null.
`engagementDistribution`	No	Members bucketed by engagement rating.
`previousPeriodAverages`	No	Single summary row of aggregate campaign metrics for the prior comparison period.
`subscriberGrowthBaseline`	No	Baseline subscriber number used for growth comparison.
`subscriberGrowthBaselineChurn`	No	Baseline churn number used for growth comparison.
`subscriberGrowthBaselineSubscribed`	No	Baseline subscribed count used for growth comparison.

Schema Changelog

Changes observed during successful MCP inspections.

Changed68 schema fields changedSep 11, 2026
- changedOutput schema / description
```
Previous value: -"Output for the sm_get_insights_advanced tool. Failure payloads arrive in the same envelope as { error, message, code }."New value: +"Output for the sm_get_insights_advanced 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 / campaignConsistency / properties / clickRateStddev / description
```
Added value: +"Click-rate standard deviation."
```
- addedOutput schema / properties / campaignConsistency / properties / maxClickRate / description
```
Added value: +"Highest click rate."
```
- addedOutput schema / properties / campaignConsistency / properties / maxOpenRate / description
```
Added value: +"Highest open rate."
```
- addedOutput schema / properties / campaignConsistency / properties / medianClickRate / description
```
Added value: +"Median click rate."
```
- addedOutput schema / properties / campaignConsistency / properties / medianOpenRate / description
```
Added value: +"Median open rate."
```
- addedOutput schema / properties / campaignConsistency / properties / minClickRate / description
```
Added value: +"Lowest click rate."
```
- addedOutput schema / properties / campaignConsistency / properties / minOpenRate / description
```
Added value: +"Lowest open rate."
```
- addedOutput schema / properties / campaignConsistency / properties / openRateStddev / description
```
Added value: +"Open-rate standard deviation."
```
- addedOutput schema / properties / computedThreshold / description
```
Added value: +"Threshold computed for the analysis, or null when not applicable."
```
- addedOutput schema / properties / engagementDistribution / description
```
Added value: +"Members bucketed by engagement rating."
```
- addedOutput schema / properties / engagementDistribution / items / properties / memberCount / description
```
Added value: +"Members in the bucket."
```
- addedOutput schema / properties / engagementDistribution / items / properties / memberRating / description
```
Added value: +"Engagement rating bucket, or null."
```
- 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 / 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 / segmentSummary / description
```
Added value: +"Segment summary rows."
```
- addedOutput schema / properties / segmentSummary / items / properties / memberCount / description
```
Added value: +"Members in the segment."
```
- addedOutput schema / properties / segmentSummary / items / properties / name / description
```
Added value: +"Segment name."
```
- addedOutput schema / properties / segmentSummary / items / properties / segmentId / description
```
Added value: +"Segment identifier."
```
- addedOutput schema / properties / segmentSummary / items / properties / segmentType / description
```
Added value: +"Segment type, or null."
```
- 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."
```
- addedOutput schema / properties / subscriberGrowthBaseline / description
```
Added value: +"Baseline subscriber number used for growth comparison."
```
- addedOutput schema / properties / subscriberGrowthBaselineChurn / description
```
Added value: +"Baseline churn number used for growth comparison."
```
- addedOutput schema / properties / subscriberGrowthBaselineSubscribed / description
```
Added value: +"Baseline subscribed count used for growth comparison."
```
- addedOutput schema / properties / tagSummary / description
```
Added value: +"Tag summary rows."
```
- addedOutput schema / properties / tagSummary / items / properties / memberCount / description
```
Added value: +"Members carrying the tag."
```
- addedOutput schema / properties / tagSummary / items / properties / name / description
```
Added value: +"Tag name."
```
- addedOutput schema / properties / tagSummary / items / properties / tagId / description
```
Added value: +"Tag identifier."
```

Changed7 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 / 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 / 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_advanced 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"
+    },
+    "campaignConsistency": {
+      "additionalProperties": true,
+      "description": "Statistical consistency metrics for campaign performance. May be null.",
+      "properties": {
+        "clickRateStddev": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "maxClickRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "maxOpenRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "medianClickRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "medianOpenRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "minClickRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "minOpenRate": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "openRateStddev": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "campaignDateRange": {
+      "additionalProperties": true,
+      "description": "Overall chronological range of campaigns. May be null.",
+      "properties": {
+        "maxSendTime": {
+          "description": "ISO 8601 UTC timestamp.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "minSendTime": {
+          "description": "ISO 8601 UTC timestamp.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "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"
+      ]
+    },
+    "engagementDistribution": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Breakdown of members by engagement rating.",
+        "properties": {
+          "memberCount": {
+            "type": "integer"
+          },
+          "memberRating": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "syncedAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "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"
+    },
+    "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"
+    },
+    "segmentSummary": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Summary metrics for segments.",
+        "properties": {
+          "createdAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "memberCount": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "options": {
+            "description": "Raw Mailchimp segment options JSON as an unparsed string that the client must parse itself",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "segmentId": {
+            "type": "string"
+          },
+          "segmentType": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "syncedAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "updatedAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "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"
+    },
+    "subscriberGrowthBaseline": {
+      "type": "number"
+    },
+    "subscriberGrowthBaselineChurn": {
+      "type": "number"
+    },
+    "subscriberGrowthBaselineSubscribed": {
+      "type": "number"
+    },
+    "tagSummary": {
+      "items": {
+        "additionalProperties": true,
+        "description": "Summary metric for a tag.",
+        "properties": {
+          "memberCount": {
+            "type": "integer"
+          },
+          "name": {
+            "type": "string"
+          },
+          "syncedAt": {
+            "description": "ISO 8601 UTC timestamp.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "tagId": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

First observedSep 10, 2026

TDQS

A4.3/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, so the non-mutating and safe nature is covered. The description adds behavioral context beyond annotations: the conditional usage ('when basic insights cannot explain a change'), the explicit exclusion list, and the fact that all three tiers return campaign averages, previous-period averages, audience summary, and auto-generated insights. It does not contradict annotations and adds scope and shared-output context, though it omits details like error handling or pagination, which is acceptable given the rich annotation coverage.

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

Conciseness4/5

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

The description is front-loaded with purpose and components, then states the usage condition, then lists exclusions and sibling references, and ends with the shared-output note. Every sentence serves a purpose, though it is slightly verbose due to the detailed exclusion lists. This is a strong 4; a 5 would require even tighter grouping of the exclusions.

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

Completeness4/5

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

Given the tool's moderate complexity (6 parameters, 1 required, output schema available) and rich annotations, the description adequately covers the decision points: when to use, what it returns, what it excludes, and what overlaps with other tools. The parameters are fully explained in the schema, and the output is defined by the output schema. The description leaves no critical ambiguity for an agent to select or invoke it correctly. A 4 is appropriate; a 5 would be reserved for even more exhaustive edge-case guidance that is not necessary here.

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% per the context, and each parameter (projectId, startDate, endDate, campaignId, minSendVolume, maxSendVolume) is already documented with formats, defaults, and constraints. The description does not add any parameter-specific meaning—it only describes the output scope. Per the rubric, a high schema coverage yields a baseline of 3, and since the description contributes no extra parameter semantics, this remains a 3.

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 starts with a specific verb ('Get') and clearly specifies the resource ('deeper audience analytics') followed by a concrete list of included analyses: engagement distribution, tag and segment summaries, subscriber-growth baseline with churn decomposition, and campaign consistency. It also names the sibling tools that handle the excluded items, making it unambiguous how this tool differs from sm_get_insights_basic and sm_get_insights_expert.

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?

It explicitly states when to use this tool ('Use when basic insights cannot explain a change') and then lists exactly what is excluded and which sibling to use instead (sm_get_insights_basic for per-campaign performance table, single-campaign detail, list overview, engagement/send-volume trends; sm_get_insights_expert for campaign fatigue, subject-line keywords, send-time heatmap, monthly trend, audience health). Additionally, it notes the shared outputs across all three tiers, giving clear routing instructions.

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?