# Flodesk MCP for AI Agents AI Agent Connect

> Flodesk MCP lets your AI agent manage email marketing, subscriber lists, and automated workflows. It handles everything from segmenting your audience to updating custom fields and triggering specific email sequences without you having to open the Flodesk dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_301vNQbFhkoEsZy5QfpSIl6KEQOZcFUCiVrtrBd8/ai-agent-connect
- **Tags:** subscriber-management, email-campaigns, audience-segmentation, newsletter-automation, marketing-analytics

## Description

When you connect Flodesk to your agent, you stop acting as a manual data entry clerk for your newsletter. Instead of hunting through different tabs to see who signed up or manually moving people into specific lists, you just tell your agent what needs to happen. It handles the heavy lifting of moving subscribers into the right buckets, updating their specific data points, and making sure they get into the right automated sequences at the right time. Whether you're trying to organize a new lead magnet list or just need to find a specific person's profile to update their status, the agent does it in seconds. It makes managing a growing audience feel like a conversation rather than a spreadsheet chore. You can find this in the Vinkius catalog to get your email marketing under control without the usual friction of navigating complex menus.

## Tools

### add_subscriber_to_segment
Put a specific person into a list you've already built. This helps you organize your audience into targeted groups for better email marketing.

### add_subscriber_to_workflow
Start a specific automated email sequence for a user right now. It's useful for sending immediate welcome emails or onboarding content.

### create_segment
Build a new group for your audience based on specific criteria. Use this to create custom lists for new campaigns or lead magnets.

### get_segment
See the details and configuration for a particular audience list. This helps you understand who is in a group and what rules apply to them.

### get_subscriber
Pull up the profile and status of a single person in your database. This is great for checking a specific user's details or opt-in status.

### list_custom_fields
See all the extra data points you're tracking for your subscribers. Use this to understand what unique information you've collected from your audience.

### list_segments
View a complete list of every group you've created for your audience. This gives you a bird's-eye view of your entire email marketing structure.

### list_subscribers
Get a full list of everyone currently signed up for your emails. Use this to see your total reach and audience growth at a glance.

### list_workflows
See every automated email sequence currently in your account. This helps you keep track of all your active marketing automations.

### upsert_subscriber
Create a new profile or update an existing one using an email address. This keeps your subscriber database accurate and up to date.

## Prompt Examples

**Prompt:** 
```
Show me all my active segments.
```

**Response:** 
```
I've retrieved your segments. You have 3 active lists:

| Segment Name | ID |
| :--- | :--- |
| Weekly Newsletter | seg_1 |
| Beta Testers | seg_2 |
| Lead Magnet | seg_3 |

Which one should I provide details for?
```

**Prompt:** 
```
Find the profile for test@example.com.
```

**Response:** 
```
I've located the profile for **test@example.com**. 

*   **Status:** Active
*   **Segments:** Weekly Newsletter
*   **Custom Fields:** 
    *   Interest: Technology
    *   Source: Twitter

Would you like to see more details or update any info?
```

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

**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

### Add subscribers to specific segments
Move people into specific audience groups instantly.

### Trigger automated email workflows
Start specific email sequences for a user immediately.

### Create new audience segments
Build new groups for your mailing list on the fly.

### View details for any specific subscriber
Pull up a person's profile to see their status and data.

### List all available custom fields
See what unique data points you are tracking for your audience.

### Retrieve all current subscriber segments
See a full list of every group you have created.

### List all active subscribers
Get a complete count of everyone on your mailing list.

### View all existing workflows
See every automated email sequence currently in your account.

### Create or update subscriber profiles
Add new people to your database or refresh existing details.

## Use Cases

### New Lead Magnet Signup
A creator wants to put a new signup into a 'Lead Magnet' list. They ask the agent to use `add_subscriber_to_segment` to handle it.

### Welcome Sequence Trigger
A manager wants to start a 'Welcome Flow' for a new lead. The agent uses `add_subscriber_to_workflow` to trigger the emails immediately.

### Subscriber Data Cleanup
A founder needs to update a subscriber's status or info. The agent uses `upsert_subscriber` to refresh their profile without manual editing.

### Audience Research
A marketer wants to see who's on the 'Beta' list. The agent uses `list_segments` and `get_segment` to provide a quick summary.

## Benefits

- Stop manual list sorting by using `add_subscriber_to_segment` to group people instantly.
- Start email sequences immediately with `add_subscriber_to_workflow` instead of waiting for a manual trigger.
- Organize your audience better by creating new groups with `create_segment` on the fly.
- Get instant answers about your audience by using `list_subscribers` and `list_segments` to see your growth.
- Keep your data clean by using `upsert_subscriber` to maintain accurate profiles for every person on your list.
- Access specific user data easily with `get_subscriber` to see exactly what a person needs.

## How It Works

The bottom line is you get a hands-off way to manage your entire email marketing database through natural language.

1. Subscribe to this Connector and get your API key from your Flodesk settings.
2. Connect your key to your agent in Claude, Cursor, or Windsurf.
3. Ask your agent to manage your lists, update profiles, or trigger workflows.

## Frequently Asked Questions

**Can the Flodesk MCP help me manage my newsletter subscribers?**
Yes, it lets your AI agent handle the heavy lifting of organizing your audience, updating profiles, and managing your mailing list without you having to log into the dashboard.

**How does the Flodesk MCP handle audience segments?**
It allows you to create, list, and move subscribers into specific groups using natural language. You can organize your audience into targeted lists instantly.

**Can I use the Flodesk MCP to trigger automated emails?**
Yes, your agent can use the tool to put people into specific workflows immediately. This is perfect for starting welcome sequences or onboarding flows.

**Does the Flodesk MCP support custom subscriber data?**
It lets you access and update custom fields so your agent knows specific details about your audience, like their interests or where they signed up from.

**Is the Flodesk MCP good for scaling a lead magnet?**
It's great for scale because it automates the process of adding new signups to the right lists. Your agent can handle the volume while you focus on the content.

**Can the Flodesk MCP help me clean up my subscriber list?**
You can use it to update profiles and ensure your data stays current. It makes it easy to refresh subscriber details across your entire database.

**How do I find my Flodesk API Key?**
Log in to your Flodesk account, navigate to **Settings** > **Integrations** > **API keys**, and click **Generate new key**.

**Can I search for a subscriber by email?**
Yes! Use the `get_subscriber` tool and provide the email address to retrieve their profile, segments, and status.

**How do I trigger an automation for a subscriber?**
Use the `add_subscriber_to_workflow` tool by providing the unique `workflow_id` and the subscriber's ID or email address.