Flodesk MCP. Manage email lists and funnels via conversation.

Q: Does Flodesk MCP allow me to add new subscribers?

Absolutely. You use the createsubscriber tool to instantly add a brand-new contact record to your Flodesk list, getting them into your system immediately.

Q: How do I make sure a user gets the right onboarding emails?

You can first use addtosegment to place the new lead in the 'New Client' segment. Then, tell your agent to run the sequence using triggerworkflow, ensuring they get started correctly.

Q: Can I check what custom data I’m missing?

You can use listcustomfields to see every piece of metadata already tracked. This helps you decide if you need to create new fields using createcustomfield.

Q: What is the difference between listing subscribers and getting a subscriber?

Listing (listsubscribers) gives you a batch view of many contacts. Getting (getsubscriber) retrieves all the deep profile details for one specific person at a time.

Flodesk manages your email list and automation funnels entirely through AI agents. Use this MCP to manage subscribers, organize segments, run workflows, and track form performance without ever leaving your chat window. It lets you talk to your marketing data—listing contacts, updating profiles, or kicking off complex sequences—and get immediate action.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Give Claude and any AI agent real-world access

Manage Subscriber Lists

Get lists of all contacts or fetch detailed information on a single subscriber.

Update and Add Contacts

Create new subscribers, update existing profiles with custom data, or unsubscribe users directly through the agent.

Segment Audience Groups

List your defined segments and move specific contacts into groups to target them accurately.

Run Automated Campaigns

Check active email sequences and trigger a workflow for any user instantly.

Monitor Lead Sources

Retrieve lists of your opt-in forms to know exactly where new leads are coming from.

Ask an AI about this

Waiting for input…

AI Agent

What AI agents can do with Flodesk: Subscriber & Workflow Ops (12 Tools)

Use these 12 tools to manage every aspect of your email list, from adding new contacts to running full automation sequences.

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 Flodesk MCP

Add To Segment

Move a specific subscriber into an existing audience group (segment).

Trigger Workflow

Start an automated email sequence for a designated user.

Create Custom Field

Build new fields to store specific data, like purchase history or interests.

Create Subscriber

Add a brand new contact record to your Flodesk list.

Get Account Details

Fetch general metadata about the connected Flodesk account for context checking.

Get Subscriber

Retrieve all profile data for a single, specified subscriber.

List Custom Fields

List all the custom metadata fields currently available on your subscribers.

List Forms

Retrieve a list of every opt-in form you have created.

List Segments

Get names and details for all existing audience segments.

List Subscribers

Fetch a list of email subscribers, often filtered by date or count.

List Workflows

See an overview of all active automated email sequences.

Unsubscribe Subscriber

Remove a user from your mailing list while maintaining compliance.

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 Flodesk 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": {
  "flodesk": {
    "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 Flodesk 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:

"flodesk": {
  "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 each call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

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

Your data is protected. See how we built it.

Dealing with marketing data feels like juggling tabs all day long.

Today, running even a simple campaign means jumping through hoops. You might check your form submissions in one tab, cross-reference the resulting list against your segments in another, and then finally manually select users to launch a workflow—all while copying usernames and email addresses into third-party sheets for review.

With this MCP, you just talk to your agent. You tell it what you need done with your audience data, and it handles all the underlying checks, updates, and triggers across Flodesk's system. It’s not about moving data; it’s about getting actions completed.

Flodesk MCP: Full Control Over Your Audience Lifecycle

The manual steps that disappear are the repetitive lookups—you don't have to list users by hand to check their segment status. You eliminate the need to click 'select multiple contacts,' then navigate to a separate tab to trigger an action, making the entire process conversational.

Now, your marketing operations run on natural language commands. Your agent acts as the single pane of glass for Flodesk, turning complicated backend logic into simple instructions.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

subscriber-management

email-campaigns

workflow-automation

audience-segmentation

creator-tools

marketing-funnels

What Flodesk MCP does for your AI

This MCP connects Flodesk directly to your AI agent, giving it the power to handle almost every aspect of your email marketing and audience management. You don't need to navigate dozens of tabs just to update a contact record; you simply ask your agent to do it. Need to welcome new leads or clean up old accounts? Just tell your agent.

It manages everything from listing all subscribers and fetching specific profile data, to adding people to targeted segments and kicking off entire automated workflows.

Beyond basic list management, you can use the MCP to track where your audience comes from by retrieving a list of opt-in forms or building custom metadata fields for things like purchase history. If you're looking at options outside of dedicated marketing platforms, this Vinkius catalog connection lets any compatible AI client handle these complex tasks using natural conversation.

It makes running multi-step campaigns as simple as chatting with your agent.

Built · Hosted · Managed by Vinkius Flodesk MCP - Manage Subscribers, Segments & Workflows

Server ID 019d759b-a5ce-70be-8d0d-a30aae22fe69

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Benefits of connecting Flodesk MCP

You can move past manual segment management. Use add_to_segment to place contacts into target groups based on AI decisions, ensuring hyper-targeted messaging.

Never miss a sales opportunity because of outdated data. Fetch detailed records using get_subscriber and update custom info with create_custom_field in one go.

Automate complex user journeys instantly. Instead of going into the platform to launch sequences, simply tell your agent to run a workflow using trigger_workflow.

Keep your list clean and compliant by having the agent handle unsubscribes via unsubscribe_subscriber. It’s one command instead of manual cleanup.

Know exactly how leads are flowing in. Use list_forms to see all opt-in sources, giving you a clear view of where your best audience members come from.

Flodesk MCP use cases

01 01

The welcome sequence needs adjusting.

A content creator notices new leads aren't receiving the right onboarding emails. They ask their agent to list_workflows first, then use add_to_segment on a group of recent signups to ensure they get added to the correct 'New Client' segment before triggering the main welcome sequence.

02 02

Need to clean up inactive subscribers.

A marketing manager needs to remove contacts who haven't engaged in six months. They ask the agent to list_subscribers with a date filter, review the list, and then instruct the agent to unsubscribe_subscriber for those addresses.

03 03

Personalizing e-commerce outreach.

An e-commerce brand needs to segment customers who bought Product A versus Product B. They first use list_custom_fields to check what custom data is available, then ask the agent to update fields and add users to a new 'High Value' segment.

04 04

Auditing lead generation sources.

A solopreneur suspects one of their blog pages isn't collecting leads. They use list_forms to pull up all available opt-in forms and check which ones are active, ensuring no source is being overlooked.

Flodesk MCP tradeoffs

What to watch out for, and the recommended way to handle each one.

Listing every subscriber manually

Avoid

The user navigates through the Flodesk dashboard, filters by date range, scrolls down hundreds of profiles, and copies emails into a spreadsheet for review.

Instead

Instead, tell your agent to use list_subscribers. If you need specific data points like purchase history, first run list_custom_fields before asking the agent to retrieve detailed records using get_subscriber.

Forgetting to segment new leads

Avoid

A lead signs up through a form but gets treated the same as an existing customer, missing out on personalized messaging.

Instead

After creating or retrieving a new subscriber using create_subscriber or get_subscriber, immediately ask your agent to use add_to_segment so they land in the correct welcome group.

Trying to manually manage sequences

Avoid

The user has to log into Flodesk, find the 'Onboarding' workflow, and then manually select each new contact to kick off the series.

Instead

Tell your agent which contacts need attention. The agent will use add_to_segment to group them first, and then run trigger_workflow on that segment.

When to use Flodesk MCP

Use this MCP if your marketing process relies heavily on managing relationships, segments, and automated sequences based on subscriber behavior. Specifically, if you need the agent to list subscribers, fetch specific profile data with get_subscriber, or run campaigns using trigger_workflow. Don't use it if your main pain point is purely raw content creation (e.g., drafting blog posts) or advanced analytics that requires integrating multiple external systems beyond Flodesk’s scope. If you just need to track basic website traffic, a simple web hook tool might suffice; but when the action involves updating segments or running workflows, this MCP is necessary.

Frequently asked questions about Flodesk MCP

Can I use Flodesk MCP to find out which segments exist? +

Yes, you can list all available segments by asking the agent. This uses the list_segments tool and helps you know exactly where people are grouped in your audience.

Does Flodesk MCP allow me to add new subscribers? +

Absolutely. You use the create_subscriber tool to instantly add a brand-new contact record to your Flodesk list, getting them into your system immediately.

How do I make sure a user gets the right onboarding emails? +

You can first use add_to_segment to place the new lead in the 'New Client' segment. Then, tell your agent to run the sequence using trigger_workflow, ensuring they get started correctly.

Can I check what custom data I’m missing? +

You can use list_custom_fields to see every piece of metadata already tracked. This helps you decide if you need to create new fields using create_custom_field.

What is the difference between listing subscribers and getting a subscriber? +

Listing (list_subscribers) gives you a batch view of many contacts. Getting (get_subscriber) retrieves all the deep profile details for one specific person at a time.

Give Claude and any AI agent real-world access

What AI agents can do with Flodesk: Subscriber & Workflow Ops (12 Tools)

Add To Segment

Move a specific subscriber into an existing audience group (segment).

Trigger Workflow

Start an automated email sequence for a designated user.

Create Custom Field

Build new fields to store specific data, like purchase history or interests.

Create Subscriber

Add a brand new contact record to your Flodesk list.

Get Account Details

Fetch general metadata about the connected Flodesk account for context checking.

Get Subscriber

Retrieve all profile data for a single, specified subscriber.

List Custom Fields

List all the custom metadata fields currently available on your subscribers.

List Forms

Retrieve a list of every opt-in form you have created.

List Segments

Get names and details for all existing audience segments.

List Subscribers

Fetch a list of email subscribers, often filtered by date or count.

List Workflows

See an overview of all active automated email sequences.

Unsubscribe Subscriber

Remove a user from your mailing list while maintaining compliance.

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

Dealing with marketing data feels like juggling tabs all day long.

Flodesk MCP: Full Control Over Your Audience Lifecycle

subscriber-management

email-campaigns

workflow-automation

audience-segmentation

creator-tools

marketing-funnels

What Flodesk MCP does for your AI

How to set up Flodesk MCP

Who uses Flodesk MCP

Benefits of connecting Flodesk MCP

Flodesk MCP use cases

The welcome sequence needs adjusting.

Need to clean up inactive subscribers.

Personalizing e-commerce outreach.

Auditing lead generation sources.

Flodesk MCP tradeoffs

Listing every subscriber manually