Maileon MCP. Control campaigns, reports, and subscribers from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Maileon connects your AI client directly to your email marketing system. It lets you manage contacts, run campaigns, and analyze performance without opening a web portal.
Your agent can list subscribers with `list_account_contacts`, trigger dispatches via `dispatch_email_mailing`, or pull detailed open/click statistics using `get_mailing_statistics`.
What your AI agents can do
Create new contact
Adds or updates a user record in Maileon, optionally triggering the double opt-in process.
Delete account contact
Permanently removes a specified contact from your account's database.
Dispatch email mailing
Sends an email campaign, but only if the mailing has been set to a 'ready' status in Maileon.
Retrieves comprehensive lists of contacts, allowing filtering by status or metadata.
Triggers the sending process for a pre-built mailing list, provided the campaign is marked as ready.
Pulls detailed statistics for any given mailing, including open rates, click counts, and bounce totals.
Allows the removal of specific contacts or tracking recent opt-out activity to keep your data accurate.
Creates or updates user profiles, triggering double opt-in processes if configured in Maileon.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Maileon MCP Server: 9 Tools for Email Marketing Ops
These nine tools give your AI agent full control over contacts, mailings, and performance reporting within your Maileon account.
019d75cccreate new contact
Adds or updates a user record in Maileon, optionally triggering the double opt-in process.
019d75ccdelete account contact
Permanently removes a specified contact from your account's database.
019d75ccdispatch email mailing
Sends an email campaign, but only if the mailing has been set to a 'ready' status in Maileon.
019d75ccget contact by email
Pulls all stored details for one specific contact based on their email address.
019d75ccget mailing details
Retrieves general metadata about a particular campaign or mailing setup.
019d75ccget mailing statistics
Returns performance data (opens, clicks, bounces) for a specific mailings ID.
019d75cclist account contacts
Lists all contacts in your Maileon account; you can add filters to narrow the results.
019d75cclist email mailings
Shows a list of all campaigns, letting you filter by status (e.g., draft or published).
019d75cclist unsubscription events
Retrieves a log of the most recent contacts that opted out of your mailing lists.
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 Maileon, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Maileon connects your AI client straight into your email marketing system. You manage contacts, run campaigns, and check performance data without ever having to open a web portal or mess with complicated dashboards. Your agent handles the whole workflow—it's direct.
Managing Contacts and Lists
You can pull up every subscriber in your Maileon account using list_account_contacts, and you can narrow that list down by adding specific filters for status or metadata. If you need all the details on just one person, get_contact_by_email pulls up a complete profile based solely on their email address. When someone signs up, your agent uses create_new_contact to add or update that user record; this function even handles triggering the double opt-in process if Maileon requires it.
To keep things clean, you can permanently remove a specific person from your database using delete_account_contact. You'll also see a log of who quit subscribing by running list_unsubscription_events, keeping track of every contact that opted out. For general list health checks and understanding what mailings exist, list_email_mailings shows you all your campaigns, letting you filter them by status—whether they're still in draft mode or fully published.
Running Campaigns and Sending Emails
When it's time to hit send, you first check the general setup details of a campaign using get_mailing_details. Once you know the specifics, your agent triggers the actual dispatch with dispatch_email_mailing, but remember: this only sends the mail if the mailing has been marked as 'ready' inside Maileon. The whole process is controlled; you don't just hit a button and hope for the best.
Analyzing Performance Metrics
Figuring out if a campaign worked takes muscle, but your agent handles the numbers. get_mailing_statistics pulls detailed performance data—you get open rates, click counts, and bounce totals—all linked to a specific mailing ID. If you need to check the status or details of any given mailing setup, get_mailing_details gives you that metadata upfront.
How Maileon MCP Works
- 1 Subscribe to the server and enter your unique Maileon REST API Key.
- 2 Your AI client connects using the key, giving it direct access to your mailing data.
- 3 You issue a natural language command (e.g., 'What were the stats for Campaign 456?') and get an immediate, structured response.
The bottom line is you manage entire email workflows without ever leaving your chat window or IDE.
Who Is Maileon MCP For?
This is for the Marketing Operations Engineer who hates switching between 5 different dashboards. It's also for the CRM Manager whose job involves updating contact lists and checking campaign status before a morning meeting. If your day involves copy-pasting data from Maileon into Excel, you need this.
They run reports on campaigns using get_mailing_statistics and use list_unsubscription_events to maintain list quality.
They add new users using create_new_contact or check a specific user's details with get_contact_by_email before an outreach sequence.
They integrate Maileon’s mailing logic into custom tools, triggering campaigns using dispatch_email_mailing as part of a larger system workflow.
What Changes When You Connect
- Get instant campaign status. Instead of logging into the Maileon dashboard to see if a mailing is 'Ready' or 'Draft', just ask your agent. You can use
list_email_mailingsto check all campaigns in seconds. - Track performance without exporting data. When you need to know the open rate for Campaign X, run
get_mailing_statistics. You get the percentage and total counts immediately, no CSV export needed. - Maintain clean lists effortlessly. Use
list_unsubscription_eventsto see exactly who opted out recently. This helps your team decide if a contact needs permanent removal usingdelete_account_contact. - Automate data entry. When you sign up a new client, don't open the web form. Just ask your agent to run
create_new_contact, and it handles adding or updating the record correctly. - Streamline outreach preparation. Need a list of all active users? Use
list_account_contacts. You can then filter that output within your chat to pull only those who haven't opened an email in 90 days.
Real-World Use Cases
Need a quick report on last week's campaign performance.
A marketer needs to know if the 'Q3 Product Update' mailing was successful. They ask their agent to run get_mailing_statistics for that specific ID. The agent returns an immediate breakdown: 28% open rate and a 4.1% click-through, letting them report numbers instantly without navigating complex reporting sections.
Onboarding a new client requires updating their record.
A sales rep closes a deal with 'newuser@example.com'. Instead of logging into Maileon and manually inputting the data, they tell their agent to run create_new_contact. The agent handles the creation—and potentially kicks off the double opt-in process automatically.
Sending a critical, time-sensitive announcement.
The team needs to send an alert immediately. They use list_email_mailings first to verify the campaign is finished and marked 'Ready'. Once confirmed, they trigger the dispatch using dispatch_email_mailing. The agent handles the state check before sending.
Cleaning up outdated or inactive user data.
The Ops team runs a list of all contacts with list_account_contacts and filters for users who haven't engaged in 12 months. They then use the agent to run delete_account_contact on those identified stale accounts, keeping the mailing list healthy.
The Tradeoffs
Treating Maileon like a generic database.
The user tries to ask for 'all data from all users' and expects a raw dump file. They don't realize contact details are tied to specific API actions.
→
Instead, use list_account_contacts to get the list structure, then use get_contact_by_email on individual emails if you need deep, single-record data points.
Sending a mailing before it's ready.
The user blindly asks the agent to send Campaign ID 9876. The agent fails because they didn't confirm the campaign was finalized and marked as 'Ready'.
→
First, use list_email_mailings to verify the status. Once you see it says 'Ready', then run dispatch_email_mailing. Don’t skip the state check.
Ignoring opt-outs.
The team keeps sending emails to addresses that have recently unsubscribed, leading to hard bounces and poor sender reputation.
→
Periodically run list_unsubscription_events so your agent can keep track of recent opting users. Use this log when planning future contact segments.
When It Fits, When It Doesn't
Use Maileon if the core task is managing, reporting on, or updating contacts and campaigns within a dedicated email marketing platform like Maileon. This MCP server gives you granular control over data entry (create_new_contact) and execution (dispatch_email_mailing). Don't use it if your primary need is general CRM data (like purchase history) that lives outside of the mailing system, or if you just want to write a simple email draft—those require dedicated writing tools. If you only need basic listing without filtering capabilities, you might be okay with other services, but for reliable reporting and state checking, this server is necessary.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Maileon. 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
Works with 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 server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Juggling tabs and copy-pasting campaign metrics is exhausting.
Today, getting a full performance snapshot means opening the Maileon portal. You jump to the campaigns list, click into the specific mailing ID, navigate to the 'Statistics' tab, then maybe you have to download a CSV and open it in Excel just to calculate the overall average open rate across multiple reports. It’s tedious.
With this MCP server, that entire process collapses. You simply ask your agent: 'What was the total click-through rate for all campaigns last month?' The agent runs `get_mailing_statistics` and gives you the final number in plain text—no dashboards, no clicks, just the answer.
Maileon MCP Server: Control contacts, mailing & reports
The old way of updating a contact meant logging into Maileon's form, finding the user by email, and manually changing their subscription status. If you missed a step or used the wrong API endpoint, the data was corrupted.
Now, your agent handles it. You tell it: 'Mark newuser@example.com as unsubscribed.' It runs `delete_account_contact` correctly, ensuring the change is recorded and accurate every time.
Common Questions About Maileon MCP
How do I check campaign status with list_email_mailings? +
You run list_email_mailings. This tool returns a list of all campaigns, and critically, it lets you filter the results by state (like 'draft' or 'ready'). You can see exactly which ones are live and which need work.
What is the difference between listing contacts and getting one with get_contact_by_email? +
Use list_account_contacts when you need a broad overview or a filtered list of many people. Use get_contact_by_email when you know the email address and only want to pull all specific details for that single user.
Can I send an email campaign if it's still in draft mode? (dispatch_email_mailing) +
No. The dispatch_email_mailing tool checks the mailing status first. It requires the campaign to be explicitly marked as 'ready' before it will attempt to send anything.
How do I clean up my contact list using Maileon MCP Server? +
You combine tools. First, use list_unsubscription_events to see who left recently. Then, you can run delete_account_contact for those specific users if you want them permanently removed.
If I run get_contact_by_email with an invalid email address, what should I expect? +
The API returns a specific error code indicating that no contact was found. This lets your agent handle the missing data gracefully rather than failing the entire process.
When using create_new_contact, how do I ensure I only update existing profile details instead of adding a duplicate? +
You must pass the contact's unique identifier or email address in the payload. The tool checks for existence first; if it finds a match, it updates the record rather than creating a new one.
Can I filter the results of list_account_contacts by specific fields like 'status' or 'last login date'? +
Yes, you can use optional parameters when calling list_account_contacts. This allows your agent to narrow down the search results immediately, saving processing time and keeping data relevant.
What is the primary purpose of using list_unsubscription_events compared to just listing all contacts? +
This tool captures a chronological record of people opting out. It shows when someone unsubscribed, which helps track compliance and audit your mailing hygiene efforts.
How do I find my Maileon API Key? +
Log in to your Maileon account and navigate to Settings > API to generate and copy your unique REST API Key.
What is the difference between a Mailing and a Campaign? +
In Maileon terminology, a 'Mailing' refers to a specific email send-out, which is the standard entity managed via the campaigns tools in this server.
Can I filter contacts by specific attributes? +
Yes, you can provide filtering strings in the params field of the list_account_contacts tool following the Maileon query syntax.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Typefully
Write, schedule, and grow your audience on Twitter and LinkedIn with an editor that helps you craft threads that go viral.
Wistia
Manage videos, projects, and performance analytics on Wistia with AI agents.
FirstPromoter
Manage affiliates, track referrals, and handle rewards via AI agents with FirstPromoter.
You might also like
Lightspeed Restaurant
Manage restaurant orders, menus, tables, employees, payments, and revenue reports for your Lightspeed POS through natural conversation.
NASA Exoplanets — Worlds Beyond Our Solar System
Explore 5,700+ confirmed exoplanets from NASA's Exoplanet Archive: search by discovery method, find habitable zone candidates, browse transit planets from Kepler and TESS missions, and analyze global discovery statistics spanning three decades of planet hunting.
Runway ML
Empower your AI with Runway ML's advanced video generation capabilities to seamlessly create, animate, and interpolate high-quality clips using Gen-3 and Gen-4 Turbo models directly from chat.