# Flodesk MCP

> Flodesk MCP connects your email marketing and subscriber data directly to your agent. Manage entire audience lifecycles, build complex segments, and trigger automated workflows for thousands of subscribers using simple conversation prompts.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** subscriber-management, email-campaigns, audience-segmentation, newsletter-automation, marketing-analytics

## Description

This MCP lets you run your Flodesk account through natural language. Instead of clicking through dozens of menus to manage lists or check segment health, you just talk to your agent. You can get a full rundown of every subscriber in your database and even find specific custom field data points for individuals. Need to put new leads into a nurture sequence? Tell the agent; it handles adding them to the correct workflow immediately. If you're building an automated system using multiple services, Vinkius makes connecting Flodesk easy. You use this MCP to build out your entire marketing stack through simple conversation.

## Tools

### add_subscriber_to_segment
Adds one or more subscribers into an existing list segment.

### add_subscriber_to_workflow
Triggers a specific automated marketing journey for a subscriber.

### create_segment
Builds and names a brand new segment (list) for your subscribers.

### get_segment
Retrieves all details about a specific, existing subscriber segment.

### get_subscriber
Looks up the detailed profile and status of any single subscriber using their email address.

### list_custom_fields
Lists all unique data points (fields) available to track on your subscribers' profiles.

### list_segments
Pulls a complete inventory of every segment currently set up in Flodesk.

### list_subscribers
Retrieves a comprehensive list detailing all subscribers associated with your account.

### list_workflows
Shows a catalog of every automated marketing workflow you have created.

### upsert_subscriber
Creates a new subscriber profile or updates an existing one using their email address.

## Prompt Examples

**Prompt:** 
```
List all my Flodesk segments.
```

**Response:** 
```
I've retrieved your segments. You have 3 active lists: 'Weekly Newsletter' (ID: seg_1), 'Beta Testers' (ID: seg_2), and 'Lead Magnet' (ID: seg_3). Which one should I provide details for?
```

**Prompt:** 
```
Find subscriber details for 'hello@example.com'.
```

**Response:** 
```
I've located the profile for hello@example.com. They are an 'Active' subscriber and belong to the 'Weekly Newsletter' segment. Would you like to see their custom field values?
```

**Prompt:** 
```
Add subscriber 'user@example.com' to the 'Welcome Flow' workflow.
```

**Response:** 
```
Action complete! I've successfully added 'user@example.com' to the 'Welcome Flow' (ID: wflow_123). They will start receiving your automation sequence immediately.
```

## Capabilities

### Audit subscriber lists
You get a full overview of all subscribers in your account and can retrieve detailed information on any single user profile.

### Organize audience segments
The agent can list existing segments or create brand new ones to keep your subscriber data highly organized and targeted.

### Activate automated journeys
You tell the system which subscribers need attention, and it programmatically triggers a specific marketing workflow for them.

### Update user records
The MCP allows you to create or modify subscriber profiles, ensuring their contact details and opt-in status are always current.

## Use Cases

### Auditing list health before a major launch
A SaaS founder needs to know if all beta testers are correctly opted into the 'Premium Feature' segment. They simply ask their agent to run `get_segment` and check for any missing users, rather than spending an hour manually checking lists.

### Onboarding new leads efficiently
A marketing manager gets a batch of 50 new sign-ups. Instead of creating 50 separate tasks, they ask the agent to `add_subscriber_to_segment` and then `add_subscriber_to_workflow`, launching them all into the correct onboarding flow instantly.

### Data cleanup for compliance
A content creator notices some old subscribers haven't opened an email in months. They ask their agent to run a lookup on `get_subscriber` and update the status or segment using the relevant tools, ensuring clean data.

### Updating user profiles en masse
A founder changes the lead capture process. Instead of updating records manually, they use `upsert_subscriber`, directing the agent to modify custom fields for a defined list of users.

## Benefits

- You instantly get a full list of every subscriber using `list_subscribers`, eliminating the need to download and manually audit CSV files.
- Need better targeting? You can use `create_segment` or `get_segment` to build highly specific lists based on criteria, making your campaigns sharper.
- When a new lead signs up, you don't leave your workspace. Use the agent to immediately execute `add_subscriber_to_workflow`, kicking them into their welcome sequence right away.
- Stop guessing about data points. By listing custom fields with `list_custom_fields`, you know exactly what unique information you can track for every user.
- If a subscriber's details change, use `upsert_subscriber` to update their profile instantly and keep your marketing records clean without clicking through multiple forms.

## How It Works

The bottom line is, you use your AI client as a dedicated marketing coordinator that operates directly within Flodesk's backend.

1. Subscribe to this MCP on Vinkius and pull your Flodesk API key from your account settings.
2. Connect the credentials to your AI agent, granting it permission to read and write to your subscriber data.
3. Use natural language prompts in your agent to ask for segments, update profiles, or launch automated campaigns.

## Frequently Asked Questions

**How do I list all my Flodesk segments using the Flodesk MCP?**
You use the `list_segments` tool. It pulls an immediate inventory of every segment you currently maintain in your account, giving you a clean overview.

**Can I update subscriber details with the Flodesk MCP?**
Yes, you can use the `upsert_subscriber` tool. This allows you to create an entirely new profile or modify existing ones using just their email address.

**What if a user changes segments in Flodesk? Should I worry?**
The agent helps manage that with `add_subscriber_to_segment`. You can instruct it to move users into new groups or pull data from existing ones to maintain accuracy.

**Does the Flodesk MCP help me run campaigns?**
It doesn't design the content, but it triggers them. You use `add_subscriber_to_workflow` to ensure specific users start receiving your automated marketing sequence immediately after an action.

**What is the most important tool for audience data integrity?**
The `get_subscriber` tool lets you verify a single user's status and custom fields. This is crucial before making any changes to ensure you are working with accurate, up-to-date information.