Supercharge your AI with Listmonk. Segment, draft, and send emails via conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Listmonk MCP Server lets your AI client manage every step of your email marketing workflow via chat. It controls subscribers, campaigns, lists, templates, and media assets using direct API calls.
Instead of jumping between a dashboard and a spreadsheet, you tell the agent what to do—like finding all users in California who haven't opened an email in 60 days—and it runs the necessary tools for you.
What your AI can do
Create campaign
Creates a draft campaign for your newsletter series.
Create list
Builds and names a brand new mailing list segment.
Create public subscription
Sets up a publicly visible sign-up form for your site.
You query the database to find specific groups of subscribers using tools like list_subscribers, applying complex filters and SQL logic.
The agent creates new campaigns with create_campaign and moves them into a live state using update_campaign_status.
You send immediate, critical messages to subscribers using the send_transactional_message tool, bypassing standard newsletter scheduling.
The system lets you list and manipulate templates (list_templates) or media files (list_media) without ever logging into the web UI.
You delete specific records, like old bounce logs via delete_bounces, to maintain data hygiene and keep your systems fast.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Listmonk MCP Server: 28 Tools for Marketing Automation
These 28 tools let your agent query, create, update, and delete every element in your Listmonk account, giving you full API control over your email marketing data.
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 Listmonk on VinkiusCreate Campaign
Creates a draft campaign for your newsletter series.
Create List
Builds and names a brand new mailing list segment.
Create Public Subscription
Sets up a publicly visible sign-up form for your site.
Create Subscriber
Adds one new user profile to the system.
Create Template
Generates a blank email template structure.
Delete Bounces
Cleans up multiple records of failed bounce emails from your database.
Delete Campaign
Removes a campaign draft or published series entirely.
Delete List
Permanently removes an entire mailing list segment.
Delete Media
Deletes a specific image or asset file from your media library.
Delete Subscriber
Removes one individual user profile completely from the system.
Delete Template
Deletes a structured email template, making it unavailable for use.
Get Campaign
Retrieves all current details about one specific campaign by ID.
Get Import Status
Checks the progress and status of a large data import job.
Get Subscriber
Retrieves all known details for one specific subscriber profile.
List Bounces
Gets a full list of recent bounce records to check deliverability issues.
List Campaigns
Retrieves a paginated list containing all existing campaigns.
List Lists
Lists every mailing list segment you have created.
List Media
Gets a list of all media files (images, PDFs) uploaded to your account.
List Public Lists
Retrieves the names and statuses of any public-facing lists.
List Subscribers
Queries and retrieves subscribers using advanced filtering, including SQL...
List Templates
Retrieves a full list of all available email templates you've built.
Patch Subscriber
Makes small, targeted updates to specific fields on an existing subscriber record...
Send Transactional Message
Sends high-priority messages instantly to selected subscribers using a defined...
Stop Import
Halts an ongoing, large data import process immediately.
Update Campaign Status
Changes the status of a campaign (e.g., from Draft to Published).
Update List
Modifies the settings or name of an existing mailing list.
Update Subscriber
Updates specific details for a known subscriber profile.
Update Template
Changes content or structure within an existing email template.
Connect to your AI in seconds. 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 Listmonk integration is available immediately — no restart needed.
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 Listmonk, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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 Listmonk. 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 connection provides 28 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Finding and segmenting users shouldn't take 10 clicks.
Today, getting a precise list of leads requires navigating deep into the dashboard. You have to check filters for location, then filter by signup date, and maybe cross-reference an open rate metric—all while clicking through multiple pages just to copy a segment ID.
With this MCP server, you tell your agent exactly what you need: 'Give me all subscribers who signed up in Q1 but haven't opened any emails.' The agent runs `list_subscribers` and returns the filtered list immediately. It’s pure conversational control.
Send your most critical messages instantly with send_transactional_message.
Usually, an alert—like a password reset or account suspension notice—has to wait for the next newsletter cycle. You have to go through `create_campaign`, set up recipients, and schedule it, which is slow and overkill for urgent comms.
The agent lets you bypass all that overhead. By calling `send_transactional_message`, you push a high-priority message out right now, targeting only the necessary users. It's direct, immediate, and works when speed matters most.
What your AI can actually do with this
You'll use your AI client to manage every part of your email marketing operation right from the chat window. You don't need to bounce between a dashboard and a spreadsheet; you just tell your agent what you want, and it runs the necessary commands against your Listmonk data.
Managing Your Subscribers
When you need user info, you can run deep queries using list_subscribers, which lets you filter and retrieve specific groups of people with complex SQL-like expressions. If you just need details on one person, use get_subscriber to pull all known data for that profile. You've got updates? Use update_subscriber to adjust specific fields on an existing record, or if you only need a small change—say, changing their status—you can hit them with patch_subscriber.
If someone leaves the list entirely, you'll use delete_subscriber; for cleaning up data messes, the agent handles deleting multiple old bounce logs via delete_bounces.
Building and Segmenting Lists
To organize your users into groups, you can build a brand new segment using create_list, which names and sets up the list. Need to make it public so people can sign up on your site? You'll call create_public_subscription. To see what lists you already have, run list_lists; if you need the names or status of public-facing signup forms, use list_public_lists.
If a list is totally useless and needs to go, you can permanently remove it with delete_list; likewise, you modify existing segments using update_list.
Running Campaigns
Launching an email series is straightforward. You'll create the initial draft campaign by calling create_campaign. To move that draft into a live send state, use update_campaign_status. When you want to see all the campaigns that exist, run list_campaigns, and if you only need the full details for one specific series, use get_campaign.
If something goes wrong with a campaign or it's no longer needed, you can delete the draft or published series entirely using delete_campaign.
Sending Critical Messages & Templates
Sometimes you can't wait for the next newsletter. You need to send high-priority messages instantly to specific users; that’s what send_transactional_message does, and it uses templates and targets selected subscribers immediately. For content structure, you manage your templates—you generate a blank one with create_template, check existing options using list_templates, or change the content of an old template via update_template.
If a template is garbage and needs to be purged, call delete_template.
Managing Assets and Maintenance
When it comes to your media library—those images and PDFs—you can list everything uploaded using list_media, or delete specific files with delete_media. You'll also need to keep track of large data dumps; running get_import_status checks the progress of any big import job, and if it's going too slow, you can halt it right away using stop_import.
For ultimate data hygiene, besides clearing bounce logs, you can check how far along a massive data upload is by calling get_import_status; you also have tools to delete campaign drafts or lists entirely, giving you full control over the entire lifecycle of your marketing content.
019e38b8-8909-7146-b9b8-ba83dbfdbab8 
Here's how it actually works
The bottom line is: you manage complex marketing tasks through plain text prompts, not clicking through dashboards.
First, subscribe the server using your unique Listmonk URL and API Token.
Next, connect this endpoint to your preferred AI client (Claude, Cursor, etc.).
Finally, ask your agent a natural language question—for example, 'Send an alert email to all users who haven't logged in last month.' — and the agent executes the necessary sequence of tools.
Who is this actually for?
This server is for technical marketers and operations teams. Specifically, the email marketer who needs to run ad-hoc reports on segmentation or bounce rates without logging into a dashboard. It’s for developers needing reliable API wrappers for transactional emails, and content creators who need to manage templates across multiple projects quickly.
They use list_subscribers with complex filters (e.g., 'all users in list X who opened Y email') and then run create_campaign to test a new sequence.
They manage data integrity by calling list_bounces and running delete_bounces, ensuring the mailing list remains clean for high-volume sends.
They use list_templates to check available assets and then run create_template or update_template when a new brand guide requires an email overhaul.
What Changes When You Connect
You can segment audiences on the fly. Instead of manually building a complex filter in the dashboard, you simply ask your agent to list_subscribers with specific SQL criteria (e.g., 'all users who signed up last month').
Sending high-priority emails is instant. Use send_transactional_message when you need immediate communication—like a password reset or alert—without going through the full campaign creation process.
Data hygiene becomes automatic. You can check and delete old bounce records using list_bounces followed by delete_bounces, keeping your mailing list clean and reliable for high-volume sends.
Campaign status changes are simple commands. Don't navigate through multiple tabs; just ask the agent to run update_campaign_status when a draft is ready to go live.
Template management is centralized. You don't need to open the web editor to check assets; running list_templates or list_media gives you an immediate inventory of what content exists.
See it in action
Cleaning up dead leads after a campaign.
A growth manager runs a major promotion and notices high bounce rates. They ask the agent to run list_bounces first, identify the patterns, then use delete_bounces to clean the records. This prevents future sends from being flagged by spam filters due to outdated error data.
Sending a critical account update.
A developer needs to send an urgent 'API key updated' alert. They don't use a campaign; they ask the agent to send_transactional_message immediately, ensuring all active users get the high-priority notice using the correct template.
Preparing for Q3 product launches.
A marketer needs three new email assets. They first run list_templates to see what exists. Then, they ask the agent to create two new ones using create_template and finally use update_template on a third one to incorporate updated branding guidelines.
Segmenting users who haven't engaged in 90 days.
A content creator wants to re-engage inactive users. They instruct the agent to run list_subscribers with a complex filter (e.g., 'last opened < 90 days ago'). The agent returns the list of IDs, which can then be used for a targeted outreach campaign.
The honest tradeoffs
Trying to find all user emails manually.
The marketer logs into the dashboard and clicks through three different filtering screens (location -> signup date -> last opened) just to get a list of IDs to copy/paste elsewhere.
Tell your agent to run list_subscribers with all necessary filters in one prompt. The tool handles the complex querying, returning the precise data set you need instantly.
Forgetting which list a campaign belongs to.
The content creator assumes the new 'Winter Sale' email will automatically send to the main mailing list when they run create_campaign, but it fails because lists aren't assigned.
Always use list_lists first. Then, explicitly tell the agent which existing list (create_list or update_list) needs to be associated with your campaign using context-specific instructions.
Updating a subscriber's name in one place.
The ops engineer updates a user’s email address in the CRM, but then has to manually go into Listmonk and update their record separately. The data gets out of sync.
Use patch_subscriber or update_subscriber. This allows you to modify just one field (like an updated status or name) on a specific subscriber ID without touching any other data.
When It Fits, When It Doesn't
Use Listmonk if your workflow requires full control over the entire email lifecycle: creating assets, segmenting users via complex filters (list_subscribers), drafting campaigns, and executing transactional sends. You need this when you're treating marketing automation like a data pipeline.
Don't use it if you only need to view basic, static reports (e.g., 'How many total subscribers do I have?'). For that, the standard dashboard is fine. However, if your job involves any sequence of actions—checking status, updating records, sending messages, or cleaning data—this MCP Server gives you the API control needed to make those steps run instantly via conversation.
Questions you might have
How do I check if my data import was successful using get_import_status? +
You use get_import_status to retrieve the current progress. It tells you exactly where the job is—whether it's still running, finished successfully, or if there were errors that need fixing.
Can I segment subscribers using list_subscribers with complex filters? +
Yes. list_subscribers supports advanced filtering and SQL expressions. You can query for segments like 'all users in List A who haven't engaged since last month,' making segmentation powerful.
I need to change a user’s status without creating a new record. Which tool should I use? +
You should use patch_subscriber or update_subscriber. These tools allow you to modify only specific fields—like changing a status from 'active' to 'unsubscribed'—without rewriting the entire profile.
What if I need to send an email but don't have a template yet? Can I still send it? +
While send_transactional_message requires a template, you can first use create_template or update_template to build one in the chat environment before sending. The agent manages that sequence for you.
If I need to permanently remove a user from my system using `delete_subscriber`, what information do I need? +
You must provide the unique subscriber ID. This tool executes an irreversible deletion, so double-check your target records before running it.
How can I verify that the connection to Listmonk is active and working before building a complex query with `list_subscribers`? +
Run list_lists. This immediately confirms connectivity by retrieving all current mailing lists. If this succeeds, your agent has access to the basic server endpoints.
I have finished drafting an email and need to change its status from 'Draft' to 'Scheduled'. Which tool handles this state change? +
Use update_campaign_status. You supply the Campaign ID along with the target status (e.g., 'scheduled'). This changes the workflow state without altering content.
How do I clean up old images or attachments that are stored as assets, using the media tools? +
First, run list_media to see all available files and their IDs. Then use delete_media, making sure you pass the correct file ID for deletion.
Can I search for subscribers using specific SQL-like attributes? +
Yes! Use the list_subscribers tool with the query parameter. You can use SQL expressions to filter by attributes, names, or email patterns directly through the agent.
How do I send a one-off transactional email to a user? +
Use the send_transactional action. You just need to provide the subscriber's email or ID and the template ID you wish to use for the message.
Can I stop an ongoing subscriber import if I notice an error? +
Absolutely. Use the stop_import tool to immediately halt any active subscriber import process in your Listmonk instance.
We've already built the connector for Listmonk. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 28 tools are live and waiting.
You're up and running in seconds.
Gemini 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.