Maileon MCP for AI. Control campaigns, reports, and subscribers from chat.

Q: How do I check campaign status with listemailmailings?

You run listemailmailings. 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.

Q: What is the difference between listing contacts and getting one with getcontactbyemail?

Use listaccountcontacts when you need a broad overview or a filtered list of many people. Use getcontactbyemail when you know the email address and only want to pull all specific details for that single user.

Q: Can I send an email campaign if it's still in draft mode? (dispatchemailmailing)

No. The dispatchemailmailing tool checks the mailing status first. It requires the campaign to be explicitly marked as 'ready' before it will attempt to send anything.

Q: How do I clean up my contact list using Maileon MCP Server?

You combine tools. First, use listunsubscriptionevents to see who left recently. Then, you can run deleteaccountcontact for those specific users if you want them permanently removed.

Q: Can I filter the results of listaccountcontacts by specific fields like 'status' or 'last login date'?

Yes, you can use optional parameters when calling listaccountcontacts. This allows your agent to narrow down the search results immediately, saving processing time and keeping data relevant.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

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 can do

List account contacts

Lists all contacts in your Maileon account; you can add filters to narrow the results.

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.

+ 6 more capabilities included

List and filter subscriber records

Retrieves comprehensive lists of contacts, allowing filtering by status or metadata.

Execute email campaigns

Triggers the sending process for a pre-built mailing list, provided the campaign is marked as ready.

Analyze performance metrics

Pulls detailed statistics for any given mailing, including open rates, click counts, and bounce totals.

Maintain contact list hygiene

Allows the removal of specific contacts or tracking recent opt-out activity to keep your data accurate.

Manage new subscriber records

Creates or updates user profiles, triggering double opt-in processes if configured in Maileon.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

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.

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 Maileon on Vinkius

List Account Contacts

Lists all contacts in your Maileon account; you can add filters to narrow the results.

Create New Contact

Adds or updates a user record in Maileon, optionally triggering the double opt-in...

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...

Get Contact By Email

Pulls all stored details for one specific contact based on their email address.

Get Mailing Details

Retrieves general metadata about a particular campaign or mailing setup.

Get Mailing Statistics

Returns performance data (opens, clicks, bounces) for a specific mailings ID.

List Email Mailings

Shows a list of all campaigns, letting you filter by status (e.g., draft or...

List Unsubscription Events

Retrieves a log of the most recent contacts that opted out of your mailing lists.

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.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Maileon integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "maileon": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Maileon tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"maileon": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

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

Start building

Make Your AI Do More

Start with Maileon, 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 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

Your data is protected. See how we built it.

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 connection provides 9 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

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.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius Maileon MCP Server - Manage Email Contacts & Campaigns

Server ID 019d75cc-60eb-7319-b313-ec5b6993ea35

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Who is this actually 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.

Marketing Operations Specialist

They run reports on campaigns using get_mailing_statistics and use list_unsubscription_events to maintain list quality.

CRM Manager

They add new users using create_new_contact or check a specific user's details with get_contact_by_email before an outreach sequence.

Software Developer

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_mailings to 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_events to see exactly who opted out recently. This helps your team decide if a contact needs permanent removal using delete_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.

See it in action

01 01

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.

02 02

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.

03 03

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.

04 04

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 honest tradeoffs

Treating Maileon like a generic database.

Anti-pattern

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.

The Fix

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.

Anti-pattern

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'.

The Fix

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.

Anti-pattern

The team keeps sending emails to addresses that have recently unsubscribed, leading to hard bounces and poor sender reputation.

The Fix

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.

Questions you might have

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? +

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.

Connect to your AI in seconds.

List account contacts

Create new contact

Delete account contact

Maileon MCP Server: 9 Tools for Email Marketing Ops

Make your AI actually useful.

List Account Contacts

Create New Contact

Delete Account Contact

Dispatch Email Mailing

Get Contact By Email

Get Mailing Details

Get Mailing Statistics

List Email Mailings

List Unsubscription Events

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Juggling tabs and copy-pasting campaign metrics is exhausting.

Maileon MCP Server: Control contacts, mailing & reports

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Need a quick report on last week's campaign performance.

Onboarding a new client requires updating their record.

Sending a critical, time-sensitive announcement.

Cleaning up outdated or inactive user data.

The honest tradeoffs

Treating Maileon like a generic database.

Sending a mailing before it's ready.

Ignoring opt-outs.

When It Fits, When It Doesn't

Questions you might have