Freshmarketer MCP. Manage contacts, lists & events with conversation.
Freshmarketer connects your entire marketing automation suite to any AI client, letting you manage contacts, build lists, and trigger email campaigns through natural conversation. Instead of clicking through dashboards, simply ask your agent to segment an audience or post a custom event timeline update. It lets you run complex marketing operations directly from your chat interface.
Give Claude and any AI agent real-world access
Retrieve detailed profiles of existing contacts, list all available records, or create new ones using simple commands.
List configured mailing lists to see how your audience is segmented, or build entirely new lists from scratch.
Trigger specific transactional emails directly for single contacts or entire campaigns without needing the marketing dashboard.
Post custom events to a contact's timeline, which programs your automation flows and updates their record instantly.
Access status details for all active or paused marketing automation campaigns.
Ask an AI about this
Waiting for input…
What AI agents can do with Freshmarketer: 10 Tools for Marketing Automation
These tools let your agent perform every marketing action—from listing contacts to sending personalized emails—using simple 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 Freshmarketer MCPCreate Mailing List
Creates a brand new mailing list within your Freshmarketer account.
Check Account Status
Verifies the current API status of your Freshmarketer account credentials.
Get Contact Details
Retrieves specific metadata and details for any given contact record.
List Contacts
Lists a queryable set of all marketing contacts in your system.
List Custom Events
Displays all the custom events you have configured for use in automation flows.
List Journeys
Retrieves a list of currently active or paused marketing journeys.
List Mailing Lists
Shows all the mailing lists that have been configured in your account.
Post Custom Event
Triggers and logs a specific custom event onto a contact's timeline for tracking...
Send Transactional Email
Sends an immediate, single transactional email to one or more contacts.
Upsert Contact
Either creates a new contact record or updates existing details for a specific...
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 each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Freshmarketer, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshmarketer. 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 CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The daily battle of logging into five different tabs just to update one contact.
Every day, the marketing team wastes time context-switching. You check the CRM for a profile, jump to the list manager to see segmentation, then open the journeys dashboard to confirm if an event was logged correctly. It’s a dozen clicks just to ensure one lead is ready for follow-up.
With this MCP, you stop clicking and start talking. You tell your agent what needs fixing—for example, 'Update john@example.com's status and send him the welcome email.' The system handles `upsert_contact` and `send_transactional_email` in a single conversation flow.
Freshmarketer MCP: Full Control Over Your Campaigns
The most tedious parts of marketing management disappear. You never have to manually check if an automation journey was successfully triggered, or spend time confirming which list a user belongs to.
You get immediate operational control over your entire audience lifecycle. The MCP lets you programmatically manage every stage of the funnel—from initial contact detail collection with `list_contacts` to triggering complex sequences via `post_custom_event`.
What Freshmarketer MCP does for your AI
This MCP connects your Freshmarketer account to any AI client, giving you complete control over your marketing database and campaigns. You can manage contacts, organize mailing lists, and trigger personalized emails without ever leaving your agent window. Need to find out who hasn't opened an email in 60 days? Just ask.
Want to send a specific follow-up campaign to the top 1% of leads? The MCP handles it. It lets you list all contacts, check their profiles, and even post custom events directly to trigger automated journeys. This capability means you run complex marketing logic using simple conversations, making your entire catalog available through Vinkius.
It's about talking to your marketing system like you talk to a coworker, getting the data or action you need immediately.
019d75a0-80fa-7237-ae39-64e689ede7cc How to set up Freshmarketer MCP
The bottom line is that you get conversational control over complex marketing systems.
Subscribe to this MCP through the Vinkius Marketplace and enter your Freshmarketer Domain prefix and API Key.
Connect this MCP to your preferred AI client (Claude, Cursor, etc.) for access.
Start a conversation with your agent by asking it to perform a marketing action, like 'List all contacts who signed up last week.'
Who uses Freshmarketer MCP
Anyone whose job involves moving data between a CRM and an email platform. Marketing Managers, Growth Engineers, and Sales Development Reps who spend too much time clicking through multiple dashboards need this.
Checks if the 'Newsletter Subscribers' list is active, or triggers a follow-up email sequence for users who haven't opened an email in 30 days.
Automates posting custom events—like 'Trial Started'—to trigger specific customer journeys without manually updating the CRM record.
Verifies contact details for a prospect and immediately sends a personalized follow-up email based on the conversation context.
Benefits of connecting Freshmarketer MCP
Automate contact updates: Instead of logging into the CRM to verify data, you simply ask your agent to use get_contact_details or upsert_contact, and it handles the record management instantly.
Instant segmentation: Need a list of users who failed to open an email? You can call list_mailing_lists and filter contacts directly through conversation, skipping manual report generation.
Trigger complex workflows: Use post_custom_event to mark a contact as 'Attended Webinar.' This action immediately triggers the correct automated sequence without human intervention.
Run targeted campaigns on demand: Need to send a quick follow-up? You don't navigate to email marketing; you just tell your agent to use send_transactional_email for immediate dispatch.
See campaign status at a glance: Quickly review all active flows by asking the agent to list_journeys, saving minutes of clicking through dashboard tabs.
Freshmarketer MCP use cases
A prospect just finished onboarding, and you need to kick off their welcome sequence.
Instead of navigating to the CRM, finding the user's record, and manually triggering an event, you ask your agent: 'Post a 'Welcome Onboarded' custom event for newuser@example.com.' The system executes this via post_custom_event, immediately starting their personalized journey.
You realize the main list is missing people who signed up through a different channel.
You ask your agent to pull all recent leads and then tell it to use list_contacts followed by create_mailing_list and populate that new list. You don't have to export, clean, and re-import the data yourself.
A key stakeholder needs a quick report on all active marketing lists.
You ask your agent: 'What are our top 5 mailing lists?' The system uses list_mailing_lists to fetch and present the current segmentation options in natural language, saving the stakeholder from dashboard exploration.
You need to send a highly personalized email update immediately after a sales call.
After getting the contact's details via get_contact_details, you ask your agent to draft and dispatch an immediate follow-up using send_transactional_email. The entire communication loop is closed in chat.
Freshmarketer MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Manually checking contact status
Trying to find out if a client's record has been updated or what their last activity was by clicking through three different tabs and viewing the audit log.
Just ask your agent: 'What are the current details for john@example.com?' The agent uses get_contact_details to pull all necessary metadata in one go.
Creating a new list by hand
Exporting a CSV of leads, opening Freshmarketer, and manually selecting the 'Create List' option, which takes several clicks.
Tell your agent: 'Create a mailing list called 'Q3 Hot Leads' using all contacts marked as subscribed.' The tool handles create_mailing_list instantly.
Trying to run an email campaign manually
Navigating the marketing dashboard, selecting the template, choosing the recipients from a list of emails, and hitting 'Send'.
For single-instance follow-ups, just ask your agent: 'Send the quarterly update email to jane@example.com.' It uses send_transactional_email directly.
When to use Freshmarketer MCP
Use this MCP if your primary bottleneck is executing marketing actions—like sending emails, updating records, or triggering journeys—that currently require navigating multiple dashboards and clicking through forms. You need conversational access to operational data.
Don't use it if you are trying to build an entirely new database structure from scratch (you'd need a dedicated backend service) or if your process involves deep-level graphical design of email templates. This MCP is for action and data retrieval, not graphic design. If all you need is simple data listing, list_contacts works great; but if you also need to trigger an action (like sending an email), this MCP is necessary.
Frequently asked questions about Freshmarketer MCP
How do I update a contact record using Freshmarketer MCP? +
You use the 'upsert_contact' tool. You just tell your agent which fields need changing, and it updates or creates the record for you.
Can Freshmarketer MCP help me segment my audience? +
Yes. You can use list_mailing_lists to see existing segments, and by combining actions like 'list_contacts' with filtering requests, you can define new audiences on the fly.
What is the easiest way to test a marketing flow? +
You can use post_custom_event to manually trigger a custom event onto a contact's timeline. This lets you verify if your automation flows are listening for that specific action.
Does Freshmarketer MCP only work with one type of email? +
No, it handles transactional emails via 'send_transactional_email.' You can send immediate, personalized messages without having to build a full campaign journey first.
Do I need API keys for the Freshmarketer MCP? +
Yes. The setup process requires you to enter your domain prefix and API Key from your Admin Settings so that the agent can authorize all necessary actions on your behalf.