Flodesk MCP. Manage segments, subscribers, and funnels through 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.
Flodesk. Connects your email marketing and audience management to your AI agent via Model Context Protocol (MCP). Manage subscribers, build segments, and automate entire funnels without leaving your chat window.
It lets you list subscribers, add leads, and trigger complex workflows directly through conversation, keeping your outreach consistent and your list clean.
What your AI agents can do
Add to segment
Adds a specified subscriber to a named segment.
Create custom field
Creates a new custom data field for subscriber profiles.
Create subscriber
Adds a brand new email subscriber to the system.
List, fetch, create, or update individual subscriber profiles and custom data fields.
List all audience segments and add specific subscribers to groups to ensure targeted messaging.
List active email workflows and manually trigger sequences for any user, like onboarding or re-engagement.
Unsubscribe users directly through the agent, keeping your list clean and compliant.
List all active opt-in forms so you know where your audience is coming from.
Fetch metadata about your Flodesk account to ensure the agent has the correct context for your branding.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Flodesk MCP Server: 12 Tools for Email Marketing
Use these tools to manage subscriber data, define segments, run automated workflows, and enrich customer profiles directly through your AI agent.
019d759badd to segment
Adds a specified subscriber to a named segment.
019d759bcreate custom field
Creates a new custom data field for subscriber profiles.
019d759bcreate subscriber
Adds a brand new email subscriber to the system.
019d759bget account details
Retrieves general metadata about your Flodesk account.
019d759bget subscriber
Fetches all detailed profile information for a specific subscriber.
019d759blist custom fields
Lists all custom fields currently attached to your subscriber accounts.
019d759blist forms
Retrieves a list of all opt-in forms you have created.
019d759blist segments
Shows a list of all existing audience segments.
019d759blist subscribers
Lists a list of your email subscribers.
019d759blist workflows
Retrieves a list of all automated email workflows.
019d759btrigger workflow
Starts a specific automated email workflow for a given user.
019d759bunsubscribe subscriber
Removes a user from your mailing list entirely.
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 Flodesk, 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
Connect your Flodesk account to your AI agent via the Model Context Protocol (MCP). You can manage subscribers, build segments, and run entire funnels right from your chat window. You'll list subscribers, add leads, and trigger complex workflows directly through conversation, keeping your outreach consistent and your list clean.
Managing Subscriber Records
- You can list all your email subscribers using
list_subscribers. - You fetch all detailed profile information for a specific person with
get_subscriber. - You add brand new email subscribers using
create_subscriber. - You can add a specified subscriber to a named segment using
add_to_segment. - You create new custom data fields for subscriber profiles with
create_custom_field. - You list all custom fields currently attached to your subscriber accounts by running
list_custom_fields. - You remove a user from your mailing list entirely using
unsubscribe_subscriber.
Segmenting and Grouping Leads
- You see a list of all existing audience segments with
list_segments. - You use
add_to_segmentto put specific subscribers into groups, ensuring your messaging hits the right people.
Automating Customer Journeys
- You retrieve a list of all automated email workflows with
list_workflows. - You start a specific automated email workflow for any user using
trigger_workflow.
Tracking Lead Sources
- You get a list of all opt-in forms you’ve created using
list_forms.
Getting Account Details
- You retrieve general metadata about your Flodesk account with
get_account_details.
How Flodesk MCP Works
- 1 Subscribe to this server on the Vinkius Marketplace and input your Flodesk API Key.
- 2 Your AI client connects the Flodesk tools, giving the agent direct access to your email marketing data.
- 3 Use natural language to issue commands, like 'Add John Doe to the VIP segment and trigger the Welcome Flow.'
The bottom line is, you manage your entire email marketing stack through chat, instead of jumping between dashboards and clicking buttons.
Who Is Flodesk MCP For?
Marketing Ops Engineers, Content Creators, and E-commerce Marketing Managers. If your job involves coordinating segmented outreach or running complex onboarding sequences, this server is for you. Stop jumping between Flodesk and your CRM—run the whole process from one place.
Uses the agent to quickly add a new lead to a specific segment or trigger a welcome sequence after a client call.
Gets a real-time overview of subscriber counts, active workflows, and segment sizes using simple chat commands.
Automates the synchronization of customer data and segments after a purchase, triggering personalized follow-up emails.
What Changes When You Connect
- Targeted Outreach: Need to ensure a new lead gets the right messages? Use
add_to_segmentto place them instantly into the correct group, or useget_subscriberto check their current profile details first. - Automated Nurturing: Don't manually send follow-ups. Use
list_workflowsto see what sequences you have, then usetrigger_workflowto start an onboarding series for any user. - Data Accuracy: Keep your list clean and compliant. Run
unsubscribe_subscriberto remove bad contacts, or usecreate_custom_fieldto store specific metadata like 'Product Interest' for better segmentation. - Visibility: Know exactly where your audience is coming from. Run
list_formsto see all opt-in forms andlist_subscribersto audit your contact list size. - Account Context: Before running anything, use
get_account_detailsto make sure the agent has the right branding context. This prevents the agent from failing due to missing setup info. - Scaling Leads: When you get a new lead, use
create_subscriberto add them immediately, thenadd_to_segmentto put them in the right flow.
Real-World Use Cases
Onboarding a High-Value Prospect
A sales rep meets a prospect. Instead of making multiple API calls, they tell their agent: 'Add jane@company.com to the VIP segment and trigger the 7-day welcome flow.' The agent uses create_subscriber, add_to_segment, and trigger_workflow in sequence, completing the entire setup in one prompt.
Cleaning Up Stale Data
The marketing team notices old contacts are in the list. They ask the agent to list all subscribers, filter for inactive accounts, and then use unsubscribe_subscriber on the identified list. This keeps the mailing list clean and compliant.
Checking Segment Health
Before running a major campaign, a manager needs to know who is in the 'Beta Testers' segment. They ask the agent to run list_segments to confirm the segment name, and then use list_subscribers filtered by that segment name to confirm the count.
Syncing Post-Purchase Data
An e-commerce platform updates a customer's purchase history. Instead of updating the database manually, the agent uses create_custom_field to log the 'Last Purchase Date' for that customer, ensuring the next personalized email is accurate.
The Tradeoffs
Over-relying on manual list exports
The user downloads the subscriber list from the Flodesk dashboard, filters it in Excel, and then manually updates segment memberships or triggers flows based on spreadsheet changes.
→
Use the agent to automate this. First, run list_subscribers to pull the raw data. Then, use add_to_segment or trigger_workflow to execute the changes directly, logging the actions in the chat history.
Forgetting to check for existing fields
Trying to add a new data point (like 'Preferred Color') without first confirming if the field exists, leading to API errors and stalled automation.
→
Always run list_custom_fields first. Once you confirm the field name, use create_custom_field only if it's missing, or use the field name in your commands otherwise.
Running multiple API calls sequentially
Calling get_subscriber multiple times for the same user to gather all data points (e.g., profile, segments, custom data), resulting in slow, brittle execution and rate limits.
→
Structure your prompt to ask the agent to gather all necessary data in a single conversational block. Use get_subscriber to get the core profile, and then let the agent query related data in subsequent steps, minimizing back-and-forth.
When It Fits, When It Doesn't
Use this server if your marketing process involves multi-step subscriber lifecycle management. You need to perform actions like segmenting users, updating custom data, or triggering a predefined workflow based on a trigger (e.g., a form submission). You're automating the 'what happens next' part of the customer journey. Don't use it if you just need to view a static list of emails—your native Flodesk dashboard is fine. If your goal is pure reporting or bulk data download without action, you might prefer a dedicated BI tool instead of the action-oriented tools provided here.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Flodesk. 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 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Managing email funnels shouldn't require logging into three different dashboards.
Today, updating a lead's status is a nightmare. You log into Flodesk to check their segment. Then, you might need to jump to a CRM to update their purchase history. After that, you have to go back to Flodesk to trigger the 'Post-Sale' workflow. It's a cycle of clicking, copying, and pasting between three different web pages.
With the Flodesk MCP Server, you handle the whole process in one chat. You simply ask your agent to 'Add John to the VIP segment and trigger the Post-Sale flow.' The agent runs the necessary tools (`add_to_segment` and `trigger_workflow`) and gets the job done. Period.
Flodesk MCP Server: Automate subscriber actions.
The manual steps that disappear are the segment checks, the manual creation of custom data points, and the process of manually triggering sequences. You no longer have to remember which workflow ID to use or which field name to update.
The difference is that your AI client executes the tools directly. It doesn't just tell you what to do; it *does* it. That's the difference.
Common Questions About Flodesk MCP
How do I use the `add_to_segment` tool with Flodesk MCP Server? +
You tell the agent the subscriber's email and the segment name. The agent then executes add_to_segment to place them in the group. For example, 'Add alice@example.com to the Founders segment.'
Can I use `trigger_workflow` with Flodesk MCP Server? +
Yes. You just need to specify the user's email and the exact name of the workflow. The agent runs trigger_workflow and starts the automated sequence immediately.
What is the purpose of the `create_custom_field` tool? +
This tool lets you define new data points for your subscribers, like 'Interests' or 'Industry.' You use create_custom_field when you need to store specific metadata that Flodesk doesn't track by default.
Does `get_subscriber` show segment membership? +
Yes, get_subscriber retrieves the full profile, which includes current segment membership and any custom data you've stored.
What if I need to remove a user from my list? Use `unsubscribe_subscriber`? +
That's right. You use unsubscribe_subscriber when a user explicitly asks to leave. It keeps your list compliant by removing them directly.
How do I list all my opt-in forms using the `list_forms` tool? +
The list_forms tool retrieves every opt-in form you've created. You can see where your audience is signing up and monitor the source of your leads.
What is the difference between `create_subscriber` and `get_subscriber`? +
Use create_subscriber when you need to add a brand-new contact. get_subscriber pulls existing details for a user you already know about.
Can the `add_to_segment` tool handle bulk updates? +
The tool allows adding single users to a segment. For large-scale updates, you'll need to list subscribers first and then call add_to_segment for each one.
How do I add a new subscriber to a specific segment using the agent? +
You can use the 'add_to_segment' tool. Provide the subscriber's email or ID and the specific Segment ID. The agent will immediately associate the contact with that segment in your Flodesk account.
Can I trigger an automated email sequence for a user? +
Yes! The 'trigger_workflow' tool allows you to start a subscriber on any of your active Flodesk workflows. Simply provide the Workflow ID and the subscriber's email address.
How do I check if a contact is active or unsubscribed? +
Use the 'get_subscriber' tool and provide the contact's email address. The agent will retrieve the profile details, including their current status (e.g., 'active', 'unsubscribed', or 'bounced').
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
iCal Calendar Parser
Parse exported .ics calendar files from Google Calendar, Apple Calendar, or Outlook local. Let your AI find free slots, count meetings, and manage your schedule.
EnterpriseAlumni
Equip your AI agent to manage alumni networks, track engagement, and monitor member profiles via the EnterpriseAlumni API.
PagePixels
Capture website screenshots and generate visual previews programmatically with an API that handles rendering at any resolution.
You might also like
Dalil AI
Build AI assistants that understand Arabic natively and serve Middle Eastern markets with culturally aware conversational AI.
Moneypenny
Never miss a business call with dedicated virtual receptionists and live chat agents who represent your brand professionally.
Zendesk
Manage support tickets, users, and organizations on Zendesk — the complete customer service platform for high-scale teams.