# Flodesk MCP > 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. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** subscriber-management, email-campaigns, workflow-automation, audience-segmentation, creator-tools, marketing-funnels ## Description 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. ## 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. ## Prompt Examples **Prompt:** ``` List my 10 most recent email subscribers. ``` **Response:** ``` Fetching subscribers... I found your 10 most recent contacts, including 'alice@example.com' and 'bob@test.com'. Would you like to see the segments they belong to? ``` **Prompt:** ``` Add 'hello@newlead.com' to my 'Welcome' segment and trigger the 'Onboarding' workflow. ``` **Response:** ``` Actions completed! I've added the subscriber to your 'Welcome' segment and successfully triggered the 'Onboarding' email sequence for them. ``` **Prompt:** ``` Show me all my active automation workflows. ``` **Response:** ``` Retrieving workflows... You have 3 active workflows: 'Weekly Newsletter', 'Post-Purchase Survey', and 'Holiday Special'. Which one should I manage for you? ``` ## Capabilities ### 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. ## Use Cases ### 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. ### 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. ### 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. ### 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. ## Benefits - 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. ## How It Works The bottom line is that your AI agent becomes a direct extension of your Flodesk account, allowing full marketing operations through conversation. 1. Subscribe to this MCP through the Vinkius Marketplace and input your Flodesk API Key. 2. Authorize access within your preferred AI client, connecting it to your active Flodesk account data. 3. Tell your agent what you need—for example, 'Add John Doe to the VIP segment and trigger his onboarding workflow.' The agent executes the task directly. ## Frequently Asked Questions **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.