Mailercloud MCP server
Commit Oct 30, 2026Lets an AI client manage email marketing campaigns, contacts, templates, and analytics through specialized tools and agents.
Also known as mailercloud-com/mailercloud-plugin, mailercloud-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.0.1
- Last commit
- Oct 30, 2026
- License
- MIT
What is Mailercloud MCP?
Mailercloud lets an AI client manage email marketing campaigns, contacts, templates, and analytics through specialized tools and agents.
Summary generated from the project's README
About Mailercloud MCP server
Managing email marketing campaigns, contact lists, and performance analytics is possible directly through an AI client using Mailercloud. This plugin for Claude Code provides a specialized campaign-manager agent and a best-practices skill to help users move beyond raw tool usage into expert workflows. It connects to a hosted MCP server that offers over 50 tools and four guided prompts to assist with marketing tasks.
Developers and marketers can use this via Claude Code, Gemini CLI, or other MCP clients like Cline. Setup requires a Mailercloud account, and the first time a tool is used, the client will prompt for authorization via OAuth or an API key. The system includes specific slash commands such as campaign-audit for reviewing drafts, analyze-campaigns for generating action plans from recent data, and clean-list for managing subscriber segments and suppressions.
What you can do with it
- 1Audit draft email campaignsAsk the AI to review a campaign draft for errors before it is sent to subscribers.
- 2Analyze marketing performanceRequest a detailed analysis of recent email campaigns along with a suggested action plan.
- 3Clean subscriber contact listsInstruct the agent to segment non-openers and preview suppressions to maintain list health.
- 4Execute multi-step marketing workflowsHand off complex, multi-stage campaign management tasks to a specialized agent persona.
Written from the project's README. Every use case is checked against a quote from it.
How to install Mailercloud MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Mailercloud MCP in Claude Code
$ claude mcp add --transport http mailercloud-plugin https://mcp.mailercloud.com/mcpInstall Mailercloud MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailercloud-plugin": {
"url": "https://mcp.mailercloud.com/mcp"
}
}
}Install Mailercloud MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mailercloud-plugin": {
"type": "http",
"url": "https://mcp.mailercloud.com/mcp"
}
}
}Install Mailercloud MCP in VS Code CLI
$ code --add-mcp '{"name":"mailercloud-plugin","type":"http","url":"https://mcp.mailercloud.com/mcp"}'Install Mailercloud MCP in Codex
$ codex mcp add mailercloud-plugin --url https://mcp.mailercloud.com/mcpInstall Mailercloud MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mailercloud-plugin] url = "https://mcp.mailercloud.com/mcp"
Install Mailercloud MCP in Gemini CLI
$ gemini mcp add -s user --transport http mailercloud-plugin https://mcp.mailercloud.com/mcpInstall Mailercloud MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailercloud-plugin": {
"url": "https://mcp.mailercloud.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemailercloud-com/mailercloud-plugin is public and reachablegithub.com/mailercloud-com/mailercloud-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-30github.com/mailercloud-com/mailercloud-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMailercloud plugin for Claude Code
Bundles the Mailercloud MCP server together with ready-made commands, a best-practices skill, and a campaign-manager subagent — so Claude Code users get expert Mailercloud workflows out of the box, not just the raw tools.
This is a Claude Code plugin. For claude.ai / Desktop / Mobile, use the Mailercloud connector in the Claude directory instead — same server, broader reach.
What's inside
| Piece | What it adds |
|---|---|
.mcp.json |
Connects the Mailercloud MCP server (https://mcp.mailercloud.com/mcp, 50+ tools, 4 guided prompts) |
/mailercloud:campaign-audit |
Audit a draft campaign before sending |
/mailercloud:analyze-campaigns |
Analyze recent campaigns + action plan |
/mailercloud:clean-list |
Clean a list safely: preview suppressions, segment non-openers, offer verification |
mailercloud-best-practices skill |
Tool map, term-to-action glossary, pre-send checklist, deliverability & metric guidance |
campaign-manager agent |
A specialist persona for multi-step campaign work |
No changes to the Mailercloud server are required — the plugin only references it.
Install
Run these in Claude Code one at a time (each is a separate slash command — enter the first, wait for it to finish, then enter the second). Do not paste both lines together.
1. Add the marketplace:
/plugin marketplace add https://github.com/mailercloud-com/mailercloud-plugin.git
2. Install the plugin:
/plugin install mailercloud@mailercloud
Use the full
https://….gitURL above. The GitHub shorthand (mailercloud-com/mailercloud-plugin) makes Claude Code clone over SSH, which fails if you don't have GitHub SSH keys configured. The HTTPS URL works for everyone.
Then restart Claude Code if prompted, and try /mailercloud:campaign-audit.
Install in Gemini CLI
gemini extensions install https://github.com/mailercloud-com/mailercloud-plugin
Then run /mcp in Gemini CLI. mailercloud should be listed, and Gemini will ask you to sign in to Mailercloud the first time a tool runs.
Install in Cline and other MCP clients
Mailercloud is a hosted MCP server at https://mcp.mailercloud.com/mcp (Streamable HTTP, OAuth sign-in).
Step-by-step setup for Cline and other agents is in llms-install.md.
Requirements & authentication
- A Mailercloud account (sign up at https://mailercloud.com).
- The first time a Mailercloud tool runs, Claude Code connects the MCP server and prompts you to authorize — sign in to Mailercloud (OAuth) or provide a Mailercloud API key. Until you authorize, the tools will report that authentication is required; this is expected.
Verify it installed
/plugin list # should show: mailercloud@mailercloud
You should also see /mailercloud:campaign-audit and /mailercloud:analyze-campaigns in the
slash-command list, and the mailercloud MCP server under your connected tools.
Local development
To test changes without publishing, add the folder as a local marketplace:
/plugin marketplace add ./mailercloud-plugin
/plugin install mailercloud@mailercloud
Structure
mailercloud-plugin/
.claude-plugin/
plugin.json # plugin manifest
marketplace.json # makes this repo installable as a marketplace
.mcp.json # references the remote Mailercloud MCP server
commands/ # /mailercloud:* slash commands
skills/ # mailercloud-best-practices
agents/ # campaign-manager
Mailercloud MCP questions
How do I add Mailercloud MCP to Claude Code?
Run claude mcp add --transport http mailercloud-plugin https://mcp.mailercloud.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Mailercloud MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install this in Claude Code?
Add the marketplace using the full GitHub HTTPS URL and then install the plugin using the /plugin install command.
What authentication methods are supported?
You can authorize using Mailercloud OAuth or by providing a Mailercloud API key.
Can I use this with Gemini CLI?
Yes, you can install it using the gemini extensions install command and then run /mcp to see the server.