# Flodesk MCP for AI Agents AI Agent Connect

> Flodesk lets you manage your email marketing list and automate subscriber workflows using AI agents. You can quickly organize your audience into segments, trigger automated sequences, and handle opt-outs without leaving your AI client. It's built for creators and brands who need to keep their email marketing consistent without the manual overhead of a complex CRM.

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

## Description

Connect your Flodesk account to your AI agent to handle the heavy lifting of email marketing. Instead of jumping between tabs to sort through new leads or manually tagging people, you can just tell your agent what to do. You'll be able to move people into specific groups based on their behavior, start welcome sequences for new signups, and keep your list clean by handling unsubscribes on the fly. It's about making your audience management feel like a conversation rather than a chore. Whether you're trying to organize a massive list of new leads or just want to make sure your most loyal fans get the right content, this setup gives your agent the eyes and hands it needs to manage your Flodesk data directly. You can find this and thousands of other connectors in the Vinkius catalog to keep your tech stack connected.

## Tools

### add_subscriber_to_segment
Add a subscriber to a segment

### get_segment
Get details for a segment

### add_subscriber_to_workflow
Trigger a workflow for a subscriber

### create_segment
Create a new segment

### get_subscriber
Pull detailed profile data for a single user. Use this to check a specific person's info or history.

### list_custom_fields
See all your custom subscriber fields. This helps you understand what metadata you're currently tracking.

### list_segments
View all your current audience segments. This lets you see how your groups are organized at a glance.

### list_subscribers
Get a full list of your email subscribers. Use this to audit your list or find specific contacts.

### list_workflows
See all your automated email sequences. This helps you manage which automations are currently active.

### upsert_subscriber
Requires email.

Create or update a subscriber

## Prompt Examples

**Prompt:** 
```
Can you show me which automated workflows I have running right now?
```

**Response:** 
```
I've checked your Flodesk account. You currently have 3 active workflows:

* **Weekly Newsletter**
* **Post-Purchase Survey**
* **Holiday Special**

Would you like me to trigger one of these for a new subscriber?
```

**Prompt:** 
```
I just met a new lead, Sarah (sarah@example.com). Put her in the VIP group and start the onboarding sequence.
```

**Response:** 
```
Done! I've added **sarah@example.com** to your **VIP** segment and triggered the **Onboarding** workflow for her. She's all set to receive her first emails.
```

**Prompt:** 
```
Who is in my 'Early Bird' segment and do they have any custom data?
```

**Response:** 
```
Here are the subscribers in your **Early Bird** segment:

| Name | Email | Custom Interests |
| :--- | :--- | :--- |
| Alice | alice@test.com | Cooking, Hiking |
| Bob | bob@test.com | Photography |

Would you like to add anyone else to this group?
```

## Capabilities

### Add subscribers to specific groups
Move contacts into targeted segments instantly to ensure they get the right content.

### Start automated email sequences
Trigger specific workflows for new or existing users through natural conversation.

### Create new subscriber records
Add new leads to your mailing list directly from your AI client.

### Fetch account metadata
Give your agent the correct branding context for your specific account.

### View custom subscriber fields
See what specific metadata you're currently tracking for your audience.

### List all opt-in forms
Monitor where your audience is coming from by viewing all your forms.

### Organize audience segments
Access and manage your different audience groups with simple commands.

### List all email subscribers
Get a complete overview of everyone on your mailing list.

### Trigger automation workflows
Activate specific email sequences for your users on demand.

### Remove users from your mailing list
Unsubscribe users directly through the agent to keep your list clean.

### Create new custom data fields
Start tracking new metrics like purchase history or specific interests.

## Use Cases

### Adding a new lead
A creator meets a new fan and asks their agent to add 'fan@email.com' to the 'VIP' segment and trigger the 'Welcome' workflow.

### Auditing a list
A marketing manager asks for a list of all active workflows to see which sequences are running during a holiday sale.

### Data collection
An e-commerce owner asks the agent to create a new custom field for 'Last Purchase Date' to better segment returning customers.

### List cleanup
A user wants to remove a specific person from the list and asks the agent to unsubscribe them to keep the list healthy.

## Benefits

- Stop manual data entry by using create_subscriber to add leads directly from your chat.
- Keep your list clean and compliant by using unsubscribe_subscriber to handle opt-outs instantly.
- Target your audience more accurately by using add_to_segment to group people based on real-time actions.
- Get instant updates on your marketing health by using list_workflows to check your active automations.
- Personalize your outreach by using create_custom_field to track specific interests or purchase history.
- Simplify your lead tracking by using list_forms to see which opt-in points are performing best.

## How It Works

The bottom line is you get a voice-controlled command center for your entire email marketing list.

1. Add your Flodesk API Key from your account settings to Vinkius.
2. Connect your preferred AI client to the Flodesk MCP.
3. Start asking your agent to sort subscribers or trigger workflows.

## Frequently Asked Questions

**How can I use the Flodesk MCP to manage my email list?**
You can use your AI agent to perform tasks like adding subscribers, viewing segments, and triggering workflows using simple voice or text commands. It removes the need to manually navigate the Flodesk dashboard for every small change.

**Can I use this to add new subscribers to specific groups?**
Yes, you can ask your agent to add any subscriber to a specific segment immediately. This is great for organizing leads as they come in from different sources.

**Does the Flodesk MCP support triggering email workflows?**
It does. Your agent can trigger specific automated sequences for users on demand, which helps in sending timely welcome emails or promotional content.

**How do I keep my Flodesk audience segments organized?**
By using the Connector, you can ask your agent to list your segments or move people between them. This ensures your audience stays organized without manual sorting.

**Can I use the Flodesk MCP to handle unsubscribes automatically?**
Yes, you can tell your agent to unsubscribe specific users. This helps you keep your mailing list clean and compliant with privacy regulations easily.

**How does the Flodesk MCP help with my email marketing automation?**
It gives your AI agent the ability to see your active workflows and start them for users. This lets you manage complex automation logic through a simple conversation.

**Can I see my opt-in forms using the Flodesk MCP?**
Yes, you can ask your agent to retrieve a list of all your opt-in forms. This helps you see which forms are currently active and where your leads are coming from.

**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').

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