Mautic MCP for AI. Manage contacts, segments & campaigns via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Mautic MCP Server connects your Mautic marketing automation instance to any AI client. It gives your agent full control over complex workflows—from managing contacts and segmenting audiences to listing campaigns and retrieving detailed company records.
You can create new leads, track campaign performance, or update contact profiles entirely through natural conversation with zero manual clicking.
What your AI can do
Add contact to segment
Adds an existing contact record to a specified audience segment in Mautic.
Create contact
Generates and saves a brand new contact profile within the Mautic system.
Get campaign
Retrieves all details for one specific marketing campaign, given its unique ID number.
Your agent generates new contact records in Mautic using the create_contact tool.
The agent retrieves a complete profile for one person by ID, or finds multiple leads with an optional search query (get_contact, list_contacts).
You can add specific contacts to existing segments using the add_contact_to_segment tool for targeted marketing.
The agent fetches lists of all campaigns (list_campaigns) or retrieves deep details on a single campaign by ID (get_campaign).
You can list all associated company accounts (list_companies) and pull detailed data for one specific account (get_company).
Ask an AI about this
Waiting for input…
Mautic MCP Server: 11 Tools for Marketing Ops
These eleven functions let your AI agent perform core CRUD operations on contacts, companies, campaigns, and segments within Mautic.
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 Mautic on VinkiusAdd Contact To Segment
Adds an existing contact record to a specified audience segment in Mautic.
Create Contact
Generates and saves a brand new contact profile within the Mautic system.
Get Campaign
Retrieves all details for one specific marketing campaign, given its unique ID...
Get Company
Fetches the full record and associated data for a company account by providing its...
Get Contact
Retrieves the complete profile of a single contact using their unique identifier.
Get Email
Gets the full structure and content details for an email template by its ID.
List Campaigns
Returns a list of all active marketing campaigns configured in your Mautic instance.
List Companies
Provides an overview and listing of all company accounts managed by the system.
List Contacts
Lists or searches contacts across Mautic, allowing you to narrow results using a...
List Emails
Provides a list of all available email templates that can be used for marketing...
List Segments
Lists every defined audience segment, allowing you to see which groups exist for...
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 Mautic 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 Mautic, 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 Mautic. 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 11 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manually auditing Mautic data takes way too many clicks.
Today, if you need to see who's in a specific segment and then pull their full profile details, you open the Segments dashboard. You find the list. Then, for every single name on that list, you have to click into the Contacts view, search by email, and finally copy key data points—all before even starting your analysis.
With this MCP server, you just talk to your agent. You say, 'Give me the full profiles of all contacts in the 'High Value' segment.' The agent runs `list_segments` first, then executes a targeted call to `list_contacts`, pulling every necessary detail and presenting it right back to you.
The Mautic MCP Server: Control your marketing data flow.
You no longer need dedicated dashboards just for auditing. Need to know if a contact was added to the wrong segment? You ask, and the agent uses `get_contact` alongside `list_segments` to confirm their current status instantly. It's all in one conversation.
It’s not about reading reports; it’s about running complex business logic with natural language. The server lets your AI client manage data relationships—like linking a company ID (`get_company`) to the campaign performance of its contacts—in real time.
What your AI can actually do with this
Listen, forget those clunky dashboards where you gotta click a dozen buttons just to run a simple campaign. This Mautic MCP Server hooks your Mautic marketing automation straight up to your AI client, giving it full control over the whole damn workflow. Your agent doesn't just read data; it acts on it.
Managing Contacts and Leads
When you need to find someone, your agent gets the job done fast. If you know a person’s unique ID, it pulls their entire profile using get_contact. You can also search for multiple leads across Mautic by running list_contacts, letting you narrow down results with any query you throw at it.
Need to start fresh? Your agent generates and saves brand new contact records straight into the system via create_contact. Once a lead exists, you'll use list_segments to see every audience group available—it lists all defined segments. Then, if you want to target specific people for a campaign, it adds those contacts to existing groups using add_contact_to_segment.
Tracking Companies and Campaigns
Managing accounts is just as simple. If you need an overview of every company account managed in Mautic, your agent runs list_companies. Better yet, if you know a specific company's ID, it fetches the full record and all associated data using get_company. For campaigns, you can get a rundown of every active campaign configured by calling list_campaigns.
If you need deep specs on just one campaign—say, its metrics or setup details—you use get_campaign and provide its unique ID.
Handling Email Templates
It's not enough to run a campaign; you gotta make sure the email looks right. To see every email template available for marketing outreach, your agent runs list_emails. If you need the full structure and content of one specific template, it grabs those details using get_email by its ID.
Putting It All Together
It’s all about flow. You can list out every piece of data—all campaigns (list_campaigns), all segments (list_segments), or even just a quick look at available email templates (list_emails). The server gives your agent the specific tools it needs to build complex marketing operations through simple conversation with zero manual clicking.
It’s like having a dedicated, hyper-efficient ops specialist right in your chat window.
019d75d0-8bea-70ab-8043-bbe4fc585dda 
Here's how it actually works
The bottom line is: Your AI client acts as a secure, conversational layer between your natural language requests and Mautic's underlying APIs.
First, you subscribe to the Mautic server on Vinkius and provide your Mautic Base URL, username, and API secret.
Then, you tell your AI client what you need (e.g., 'Find all contacts in Segment X who haven't opened an email').
The agent uses the available tools—like list_contacts or get_contact—to execute the necessary API calls and returns the structured data to you.
Who is this actually for?
This is for the marketing ops engineer or campaign manager who hates clicking through ten different tabs in Mautic just to gather data. If you spend too much time manually cross-referencing segments, contacts, and company profiles, this server saves hours. It lets you talk about your campaigns like a human talks—and actually get the data back.
Using list_campaigns and get_company, they audit campaign setup across multiple business units, ensuring all required fields are populated without opening dozens of browser tabs.
They use create_contact or get_contact to manually onboard high-value leads into Mautic, logging the details and immediately adding them to the correct segment via add_contact_to_segment.
They use list_emails and get_email to pull template metadata quickly. They then ask their agent to list segments (list_segments) that need a specific email campaign, speeding up content deployment.
What Changes When You Connect
Stop juggling tabs. Instead of opening the Contacts view to find a lead's ID and then switching to the Segments tab to add them, your agent handles it in one prompt using add_contact_to_segment and list_segments. The whole process is conversationally direct.
Need an audit? You can list all campaigns (list_campaigns) and instantly get details on a specific company's association with that campaign by calling get_company and cross-referencing the data. It’s instant visibility into your funnel structure.
Building new lists is fast. Instead of manually running search queries and exporting CSVs, you can ask your agent to run list_contacts with specific criteria, getting the list right back without leaving the chat window.
Streamline lead intake. When a sales rep finds a great prospect, they just tell the agent their details; it runs create_contact, then uses add_contact_to_segment to get them into the nurture sequence immediately. Zero friction.
Reviewing marketing assets is simple. Want to know what templates you have? Run list_emails. Need to check if a specific email template works with a certain campaign? Use get_email alongside get_campaign for context.
See it in action
The Quarterly Data Cleanup
A marketing manager needs to ensure all 'High Value' prospects are in the correct list. They tell their agent, 'Find all contacts who haven't logged in this quarter and add them to the Retention Segment.' The agent runs list_contacts with date filters, then executes multiple calls to add_contact_to_segment. Done.
Onboarding a New Client
A sales team member finds a new company. Instead of going through the manual intake form, they tell their agent: 'Create contact for Acme Corp (ID 901) and link them to our Premium account.' The agent handles get_company details for verification, followed by create_contact. This saves five minutes of clicks.
Troubleshooting a Campaign Flop
A team member suspects a campaign failed because the email template was wrong. They ask their agent to 'Show me details on the Summer Promo campaign and verify its associated email template.' The agent calls get_campaign then uses get_email, giving the full context immediately.
Identifying New Target Audiences
A content specialist wants to write a specialized newsletter. They ask, 'List all segments that contain more than 50 contacts and list their names.' The agent runs list_segments, providing the full scope of available targeting lists for inspiration.
The honest tradeoffs
Trying to guess IDs
The user sees a contact name but doesn't know if it's ID 1234 or 5678. They try to call get_contact(name='John Doe') because they think the API supports searching by name.
Don't guess. First, run list_contacts using a search query on 'John Doe'. This will return the correct ID (e.g., 1234). Then, use that specific ID in get_contact(id=1234) to get the full record.
Updating contacts without verification
A user wants to add a contact to a segment but forgets which segments exist. They just try running add_contact_to_segment(id=1234, segment='New Leads') and fail because the segment name is wrong.
Always start by calling list_segments. This shows you all available options in Mautic. Once you have the correct segment ID or name, then use that information when running add_contact_to_segment.
Relying on a single view
A user only checks the 'Companies' tab and sees an account name. They try to manually link this company data to campaign performance without checking if Mautic has run a specific action.
Use get_company first to pull all associated data for that company ID. Then, check the results of list_campaigns. This verifies if any marketing activity is already tied to that account record.
When It Fits, When It Doesn't
Use this server if your workflow requires moving data or actions between different Mautic entities (Contacts <-> Segments; Company <-> Campaigns). For example, you need the agent to 'Get company details by ID' (get_company) and then use that information to decide which segment to update using add_contact_to_segment.
Don't use this if your goal is simply viewing data in isolation. If all you need is a list of emails, just run list_emails; don't try to combine it with company data unless the tool explicitly links them. This server excels at orchestration—it helps your agent chain together multiple tools (get_company -> then get_contact -> then add_contact_to_segment) into one conversational answer, which is what most marketing ops tasks require.
Questions you might have
How do I find all existing segments using list_segments? +
You simply ask your agent to run list_segments. It returns a comprehensive list of every segment defined in your Mautic instance, letting you see exactly where leads are grouped.
Can I create contacts with the create_contact tool? +
Yes. You tell your agent the required fields (name, email, company ID), and it executes create_contact, instantly adding the new lead record to Mautic.
What is the difference between list_contacts and get_contact? +
list_contacts shows you a broad overview or lets you search for multiple contacts. get_contact requires one specific ID and returns only that single, detailed profile.
How do I check if a contact is in the right segment? +
You can use get_contact to retrieve the full profile, which will show all associated segments. If you need to move them, use add_contact_to_segment.
Do I need list_companies before using get_company? +
No. get_company only needs the company ID number to function. However, if you don't know the ID, run list_companies first to find it.
What credentials do I need to use the `get_contact` tool? +
You'll need a valid Mautic API key or secret credential pair. The agent uses these stored keys to authenticate every request, so ensure your connection parameters are current before running any contact queries.
If I run `list_contacts` with millions of records, will there be rate limits? +
Yes, high-volume requests can hit API caps. To process huge lists, you'll need to structure your calls in smaller batches and implement backoff logic when calling list functions.
How do I ensure the data from `get_company` is ready for `add_contact_to_segment`? +
You must pass both IDs: the company ID retrieved by get_company, and the contact ID. The agent combines these inputs to execute the segment addition successfully.
How do I enable the Mautic API? +
Go to Mautic Settings > Configuration > API Settings and set 'API Enabled?' to 'Yes'. Also enable 'HTTP Basic Auth' for this integration.
Can I search for contacts by email? +
Yes! Use the list_contacts tool and provide the email address in the search parameter.
Is my Mautic data secure? +
Absolutely. Your credentials are encrypted at rest and injected securely at runtime.
We've already built the connector for Mautic. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 11 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.