Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
{/* TODO: stub cloned from _section-after-setup-atlassianmcp-common-workflows.mdx for Mailchimp MCP. Review and update connector-specific references (URLs, scopes, app-registration steps) before merging. */}
export const sectionTitle = 'Common workflows'

import { Tabs, TabItem, Aside } from '@astrojs/starlight/components'

### Get your cloud ID

Most Mailchimp MCP tools require a `cloudId` — the UUID that identifies your Atlassian cloud site. Call `mailchimpmcp_getaccessibleatlassianresources` once to retrieve it, then pass the `id` field value in every subsequent tool call.

<Aside type="note" title="Call this tool first">
Run `mailchimpmcp_getaccessibleatlassianresources` before calling any Jira or Confluence tool. The response lists every Atlassian site the user has access to. Use the `id` field as `cloudId`.
</Aside>

<Tabs syncKey="tech-stack">
<TabItem label="Node.js">
```typescript
// Step 1 — get the cloud ID
const resources = await actions.executeTool({
connectionName: 'mailchimpmcp',
identifier: 'user_123',
toolName: 'mailchimpmcp_getaccessibleatlassianresources',
toolInput: {},
});
const cloudId = resources[0].id;

// Step 2 — use cloudId in subsequent calls
const issue = await actions.executeTool({
connectionName: 'mailchimpmcp',
identifier: 'user_123',
toolName: 'mailchimpmcp_getjiraissue',
toolInput: {
cloudId,
issueIdOrKey: 'KAN-1',
},
});
console.log(issue);
```
</TabItem>
<TabItem label="Python">
```python
# Step 1 — get the cloud ID
resources = actions.execute_tool(
connection_name="mailchimpmcp",
identifier="user_123",
tool_name="mailchimpmcp_getaccessibleatlassianresources",
tool_input={},
)
cloud_id = resources[0]["id"]

# Step 2 — use cloud_id in subsequent calls
issue = actions.execute_tool(
connection_name="mailchimpmcp",
identifier="user_123",
tool_name="mailchimpmcp_getjiraissue",
tool_input={
"cloudId": cloud_id,
"issueIdOrKey": "KAN-1",
},
)
print(issue)
```
</TabItem>
</Tabs>

The `mailchimpmcp_getaccessibleatlassianresources` response looks like this:

```json
[
{
"id": "a4c9b3e2-1234-5678-abcd-ef0123456789",
"name": "My Company",
"url": "https://mycompany.atlassian.net",
"scopes": ["read:jira-work", "write:jira-work", "read:confluence-content.all"]
}
]
```

Use `id` as the `cloudId` parameter. If the user belongs to multiple Atlassian sites, the list contains one entry per site — pick the one matching the target `url`.
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{/* TODO: stub cloned from _setup-atlassianmcp.mdx for Mailchimp MCP. Review and update connector-specific references (URLs, scopes, app-registration steps) before merging. */}
import { Steps, Aside } from '@astrojs/starlight/components'

Mailchimp MCP uses Dynamic Client Registration (DCR) — no client ID or secret is needed. The only step is registering your Scalekit redirect URI as an allowed domain in Atlassian Administration.

<Steps>
1. ### Copy the redirect URI from Scalekit

In the [Scalekit dashboard](https://app.scalekit.com), go to **AgentKit** > **Connections** > **Create Connection**. Find **Mailchimp MCP** and click **Create**. Copy the redirect URI — it looks like `https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback`.

{/* TODO: add screenshot — alt: "Copy redirect URI from Scalekit dashboard for Mailchimp MCP", original src: @/assets/docs/agent-connectors/mailchimpmcp/copy-redirect-uri.png */}
2. ### Open the Rovo MCP server settings in Atlassian

- Go to [admin.atlassian.com](https://admin.atlassian.com) and select your organisation.
- In the left sidebar, expand **Rovo** and click **Rovo access**.
- Click **Rovo MCP server** in the submenu.
- Select the **Domains** tab at the top of the page.

<Aside type="note" title="Admin access required">
You must be an Atlassian organisation admin to access these settings. If you don't see **Rovo** in the sidebar, your organisation may not have Rovo enabled.
</Aside>

3. ### Add the redirect URI as a domain

- Under **Your domains**, click **Add domain**.

{/* TODO: add screenshot — alt: "Your domains section in Mailchimp MCP server administration", original src: @/assets/docs/agent-connectors/mailchimpmcp/add-domain-redirect-uri.png */}
- In the **Add domain** dialog, paste the redirect URI from Scalekit into the **Domain** field.
- Accept the terms and click **Add**.

{/* TODO: add screenshot — alt: "Add domain dialog in Mailchimp MCP server", original src: @/assets/docs/agent-connectors/mailchimpmcp/add-domain-modal.png */}
Once added, Scalekit automatically registers the OAuth client via DCR and handles token management for every user who authorizes the connection — no further configuration needed.
</Steps>
2 changes: 2 additions & 0 deletions src/components/templates/agent-connectors/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ export { default as SetupLinearSection } from './_setup-linear.mdx'
export { default as SetupLinklymcpSection } from './_setup-linklymcp.mdx'
export { default as SetupLushamcpSection } from './_setup-lushamcp.mdx'
export { default as SetupMailchimpSection } from './_setup-mailchimp.mdx'
export { default as SetupMailchimpmcpSection } from './_setup-mailchimpmcp.mdx'
export { default as SetupMicrosoftExcelSection } from './_setup-microsoft-excel.mdx'
export { default as SetupMicrosoftTeamsSection } from './_setup-microsoft-teams.mdx'
export { default as SetupMicrosoftWordSection } from './_setup-microsoft-word.mdx'
Expand Down Expand Up @@ -162,6 +163,7 @@ export { default as SectionAfterSetupLeadiqCommonWorkflows } from './_section-af
export { default as SectionAfterSetupLinearCommonWorkflows } from './_section-after-setup-linear-common-workflows.mdx'
export { default as SectionAfterSetupLinklymcpCommonWorkflows } from './_section-after-setup-linklymcp-common-workflows.mdx'
export { default as SectionAfterSetupMailchimpCommonWorkflows } from './_section-after-setup-mailchimp-common-workflows.mdx'
export { default as SectionAfterSetupMailchimpmcpCommonWorkflows } from './_section-after-setup-mailchimpmcp-common-workflows.mdx'
export { default as SectionAfterSetupMicrosoft365CommonWorkflows } from './_section-after-setup-microsoft365-common-workflows.mdx'
export { default as SectionAfterSetupMicrosoftexcelCommonWorkflows } from './_section-after-setup-microsoftexcel-common-workflows.mdx'
export { default as SectionAfterSetupMicrosoftteamsCommonWorkflows } from './_section-after-setup-microsoftteams-common-workflows.mdx'
Expand Down
89 changes: 89 additions & 0 deletions src/content/docs/agentkit/connectors/mailchimpmcp.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
title: 'Mailchimp MCP connector'
tableOfContents: true
description: 'Connect to Mailchimp''s email marketing and automation platform via Model Context Protocol. Manage audiences, campaigns, automations, and analytics through...'
sidebar:
label: 'Mailchimp MCP'
overviewTitle: 'Quickstart'
connectorIcon: https://cdn.scalekit.com/sk-connect/assets/provider-icons/mailchimp.svg
connectorAuthType: OAuth 2.1
connectorCategories: [Marketing, Automation, Communication]
head:
- tag: style
content: |
.sl-markdown-content h2 {
font-size: var(--sl-text-xl);
}
.sl-markdown-content h3 {
font-size: var(--sl-text-lg);
}
---

import ToolList from '@/components/ToolList.astro'
import { tools } from '@/data/agent-connectors/mailchimpmcp'
import { Steps, Tabs, TabItem } from '@astrojs/starlight/components'
import { AgentKitCredentials } from '@components/templates'
import { SetupMailchimpmcpSection } from '@components/templates'
import { QuickstartGenericOauthSection } from '@components/templates'
import { SectionAfterSetupMailchimpmcpCommonWorkflows } from '@components/templates'

<Steps>

1. ### Install the SDK

<Tabs syncKey="tech-stack">
<TabItem label="Node.js">
```bash frame="terminal"
npm install @scalekit-sdk/node
```
</TabItem>
<TabItem label="Python">
```bash frame="terminal"
pip install scalekit
```
</TabItem>
</Tabs>

Full SDK reference: [Node.js](/agentkit/sdks/node/) | [Python](/agentkit/sdks/python/)

2. ### Set your credentials

<AgentKitCredentials />

3. ### Set up the connector

Register your Mailchimp MCP credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

<details>
<summary>Dashboard setup steps</summary>

<SetupMailchimpmcpSection />

</details>

4. ### Authorize and make your first call

<QuickstartGenericOauthSection connector="mailchimpmcp" toolName="mailchimpmcp_mailchimp_get_account" providerName="Mailchimp MCP" />

</Steps>

## What you can do

Connect this agent connector to let your agent:

- **Note mailchimp add member** — Appends a CRM-style note to a specific member's record
- **Update mailchimp add or, mailchimp** — Adds a new subscriber to an audience or updates an existing one (upsert operation)
- **Member mailchimp archive** — Archives (soft-deletes) a contact from an audience without permanently removing them
- **Create mailchimp** — Creates a new audience (list) in the Mailchimp account with specified settings
- **Delete mailchimp** — Permanently deletes an audience and all associated member data
- **Get mailchimp** — Retrieves account details including plan information, total subscriber count, and account metadata

## Common workflows

<SectionAfterSetupMailchimpmcpCommonWorkflows />

## Tool list

Use the exact tool names from the **Tool list** below when you call `execute_tool`. If you're not sure which name to use, list the tools available for the current user first.

<ToolList tools={tools} />
5 changes: 5 additions & 0 deletions src/data/agent-connectors/catalog.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1039,4 +1039,9 @@ export const catalog: Record<string, ProviderMeta> = {
authType: 'Bearer Token',
categories: ['Communication', 'AI'],
},
mailchimpmcp: {
iconUrl: 'https://cdn.scalekit.com/sk-connect/assets/provider-icons/mailchimp.svg',
authType: 'OAuth 2.1',
categories: ['Marketing', 'Automation', 'Communication'],
},
}
Loading