EmailOctopus MCP for AI. Control your entire email marketing lifecycle via chat.
Works with every AI agent you already use
…and any MCP-compatible client








How this MCP server connects to your AI agent
EmailOctopus MCP connects your email marketing platform directly to your AI agent. You can manage lists, track performance, and run complex subscriber workflows using natural language commands.
Get full API control over campaign reporting and contact management without navigating a single web interface.
What AI agents can do with EmailOctopus Automation
Add contact to list
Adds a brand new contact to any specified email list.
Create email list
Creates and initializes a completely new subscriber list in the system.
Remove contact from list
Deletes a specific contact from a list, opting them out or archiving their membership.
Create new email lists, view existing list metadata, and programmatically add or remove subscribers.
Retrieve detailed campaign data, including open rates and click-through metrics for any historical promotion.
Change an existing subscriber's details or update their custom tags without accessing their profile page.
Start automated workflows for a specific person, mimicking a multi-step onboarding sequence when needed.
List all contacts within a given email list and filter them by status or tag.
Ask an AI about this
Waiting for input…
What AI agents can do with EmailOctopus: 12 Tools for Marketing Automation
These tools let you control every aspect of your email marketing—from listing subscribers to running advanced reports—all through simple conversational commands.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using EmailOctopus on VinkiusAdd Contact To List
Adds a brand new contact to any specified email list.
Create Email List
Creates and initializes a completely new subscriber list in the system.
Remove Contact From List
Deletes a specific contact from a list, opting them out or archiving their...
Get Campaign Details
Retrieves specific information about an email campaign, including its status and...
Get Contact Details
Fetches all specific information about one single contact record.
Get List Details
Retrieves the overall metadata and structure for a specified subscriber list.
Get Campaign Summary Report
Generates a performance report showing key metrics like open rate and click-through data for past campaigns.
List Email Campaigns
Retrieves a complete index of every sent and draft email campaign you own.
List Contacts In List
Lists all subscribers in an email list, with options to filter by current status or...
List Email Lists
Provides an index of all available subscriber lists, so you know what's out there.
Trigger Automation For Contact
Starts an automated customer journey for a person after they've been added to the...
Update Contact Profile
Modifies specific data points or tags for an existing contact record.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with EmailOctopus, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by EmailOctopus. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The Pain of Manual Data Aggregation, Solved with Vinkius AI Gateway
Today, if you need to know how many people opened the last campaign *and* what their current tags are in a secondary system, you have to log into three different platforms. You export list members from one tool, copy performance metrics from another, and then manually cross-reference them in a spreadsheet. It's slow, prone to human error, and takes half your morning.
With this MCP, all that happens inside the chat window. Your agent pulls data across those silos—from campaign results to list membership—and presents it cohesively. You get instant reports without ever leaving your primary workspace.
List and Manage Lists
The manual steps that vanish include navigating the list dashboard, clicking 'export,' finding the correct sheet tab, filtering for specific statuses, and then manually adding those contacts to a secondary segment. This is tedious bookkeeping.
Now, you simply tell your agent: 'List all active subscribers who haven't opened an email in 90 days.' The system runs the query instantly and gives you the clean list of emails—no clicks required.
What your AI can actually do with this
You're used to logging into an email service to check list health or see how well last month's newsletter did. This MCP changes that. Instead of clicking through tabs, exporting CSV files, and manually updating segments, you talk directly to your agent. You can ask it to compile a performance report for specific campaigns or instantly add new leads to multiple lists based on criteria.
It handles the whole contact journey—from initial list creation to triggering complex automated sequences. When you connect this MCP via Vinkius, your AI client becomes your dedicated marketing coordinator, giving you instant operational visibility into every subscriber and campaign metric.
019dd0e9-09d7-70dd-89ac-01e158ec1ae3 Here's how it actually works
The bottom line is, you pass your credentials once, and your AI agent handles all the complex data calls for you.
Subscribe to this MCP in the Vinkius catalog.
Retrieve your API Key from your EmailOctopus settings (Integrations > API).
Pass the key and run commands through any MCP-compatible client.
Who is this actually for?
Marketing Operations Managers who spend too much time exporting CSVs. Growth Marketers responsible for automated lead ingestion. Business Owners who need a single source of truth for audience growth and campaign metrics.
Checks list health, runs performance reports using get_campaign_summary_report, or segments subscribers by updating their profiles via update_contact_profile.
Automates lead ingestion from a sales tool, ensuring new contacts are added to the correct lists using add_contact_to_list and immediately triggered into an onboarding sequence via trigger_automation_for_contact.
Needs high-level oversight of audience size, asking for a count of contacts in specific lists using get_list_details.
What Changes When You Connect
Stop manual data exports. Instead of pulling subscriber counts into a spreadsheet, you can simply ask the agent to run list_contacts_in_list and get immediate numbers for segmentation checks.
Never miss campaign metrics again. You get full reporting by using get_campaign_summary_report, which pulls open rates and click data directly into your conversation context.
Keep your audience current. When a contact's role changes, you don't update them in the UI; you use update_contact_profile to change their tags instantly.
Automate complex follow-up sequences. If a lead hits a certain milestone, you can trigger an entire automated journey using trigger_automation_for_contact, without leaving your main workflow.
Maintain list hygiene effortlessly. You can tell the agent to check for and remove outdated or bounced users from a list using remove_contact_from_list.
See it in action
Auditing List Integrity
A team member needs to verify if an important segment of 'Beta Testers' was correctly added to the mailing list. They ask the agent to use list_contacts_in_list and filter by the 'Beta Tester' tag, instantly confirming membership count instead of clicking through hundreds of users.
Post-Campaign Analysis
The marketing lead ran a major product launch campaign. They ask for the results, prompting the agent to execute get_campaign_summary_report. The report immediately surfaces the click-through rate and total successful deliveries.
Lead Onboarding from CRM
A new lead is entered into your system via Salesforce. Instead of manually finding their list, the agent uses add_contact_to_list to place them in 'New Leads' and then immediately runs trigger_automation_for_contact to start a welcome email sequence.
Auditing Campaign History
The account owner wants an overview of all marketing efforts. They ask the agent to use list_email_campaigns, getting a full, searchable index of every promotion run over the last year.
The honest tradeoffs
Trying to find missing data
A user tries to figure out if a contact exists by guessing or asking vague questions like 'Is John on the list?' and gets no concrete answer.
First, use get_contact_details with the email address. If they exist, you can then check their membership using list_contacts_in_list. This two-step process ensures accuracy.
Modifying data without confirmation
A user blindly runs an update command assuming all contacts need the same tag change, potentially overwriting critical data or targeting the wrong group.
Always use list_contacts_in_list first to confirm who is in scope. Then, run update_contact_profile only on that confirmed segment.
Bypassing list creation
A user tries to add a contact to a non-existent marketing group because they forgot it had to be set up first.
Always start by using create_email_list if the destination group doesn't exist. Then, use add_contact_to_list.
When It Fits, When It Doesn't
Use this MCP when your marketing process involves structured data flows: adding contacts, tracking performance metrics, or running defined automation sequences. If you need to check the basic structure of a list, use get_list_details. Don't use it if your primary goal is simply drafting copy or brainstorming campaign ideas; those are content tasks. You should only use this when data movement and verification are required. For simple lookups (e.g., 'What email was John using?'), the general contact tools are fine, but for managing relationships between contacts, lists, and campaigns, this MCP is essential.
Questions you might have
How do I check campaign performance using get_campaign_summary_report? +
You simply tell your agent to run get_campaign_summary_report for the desired ID. It pulls metrics like open rates and click-through data immediately, so you don't have to guess or look up old dashboards.
Can I add a contact using add_contact_to_list? +
Yes, add_contact_to_list handles adding new contacts. You just need to provide the email address and specify which list they should be placed in.
What tools do I use to see all my lists? +
Use list_email_lists. This tool provides an index of every single subscriber list you have created, making it easy to know what segments are available for your next campaign.
How do I update a contact's profile? (update_contact_profile) +
update_contact_profile modifies an existing person's data. You tell the agent which contact to change and what specific field or tag needs updating.
What do I need to consider when using the `create_email_list` tool? +
You must specify a unique name and description for the new list. The MCP requires these fields to ensure your lists are properly categorized within EmailOctopus. This prevents naming conflicts, so always plan your list structure before calling this tool.
If I use `remove_contact_from_list`, what happens if the contact is already deleted or never existed? +
The system handles these cases gracefully and will return an error code indicating the resource wasn't found. You don't need to worry about causing a failure; the tool simply reports that the specified action could not be performed for that contact.
Does `trigger_automation_for_contact` require any setup outside of this MCP? +
Yes, you must ensure the API trigger is enabled within your EmailOctopus account settings. The tool relies on this external setting to start complex customer journeys for a contact. Check your platform's integration documentation first.
How can I refine my search results when using `list_contacts_in_list`? +
You pass filter parameters like 'status' or 'tag' directly into the tool request. This lets you narrow down results, for example, showing only contacts marked as 'Unsubscribed' or those with a specific tag.
How do I find my EmailOctopus API Key? +
Log in to your account, navigate to Integrations > API, and click Create Key to generate your unique access token.
Can I update custom fields for a contact? +
Yes! The update_contact_profile tool allows you to modify tags and any custom data fields associated with a subscriber.
How do I check the performance of a sent campaign? +
Use the get_campaign_summary_report tool with a campaign ID to retrieve real-time metrics including open and click rates.
We've already built the connector for EmailOctopus. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.