# EmailOctopus MCP for AI Agents AI Agent Connect > EmailOctopus lets you run your entire email marketing operation through an AI agent. You can build lists, manage subscribers, and pull campaign reports without leaving your workspace. It's built for startups that need to move fast without getting bogged down in a complex UI. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_XGg83Oh2pwWxOY3iSgezfJVwun4QCtDJoWPCiDPm/ai-agent-connect - **Tags:** emailoctopus, email-marketing, automation-api, subscribers-management, email-lists, campaign-reports, newsletter-automation, mcp ## Description You spend half your day jumping between different tabs just to see who signed up for your newsletter or how your last campaign actually performed. It's a chore to manually export CSVs just to clean up a list or to trigger a specific welcome sequence for a new lead. This Connector changes that by letting your AI agent handle the heavy lifting for you. Instead of clicking through nested menus, you just tell your agent to add a new subscriber, update a tag, or pull the open rates for last week's blast. You can manage your entire audience lifecycle and see your marketing data in real-time right where you already work. Because Vinkius makes it so easy to connect these types of tools, you can finally stop treating email marketing as a manual data entry job and start treating it like a conversation. ## Tools ### create_email_list Create a new subscriber list for a specific marketing initiative. This helps you organize different segments quickly. ### remove_contact_from_list Delete a specific contact from a list to keep your audience clean. Use this to manage unsubscribes or list pruning. ### get_campaign_details Get the specific details for a single campaign. This is useful for looking up specific metadata for old blasts. ### get_contact_details Pull the full profile and history for a specific contact. Use this to see a user's full journey and tags. ### get_list_details View the metadata and specifics of an existing email list. It helps you see the underlying structure of your lists. ### get_campaign_summary_report Pull the open and click rates for a past campaign. This gives you a quick pulse on how your audience is reacting. ### list_email_campaigns See a list of all your sent and draft campaigns. Use this to keep track of what's been sent and what's next. ### list_contacts_in_list See who is on a specific list, with the option to filter by status. This is great for auditing your current subscribers. ### list_email_lists Get a full list of all your current subscriber lists. Use this to see your entire marketing structure at a glance. ### trigger_automation_for_contact Start a specific automated sequence for a chosen contact. This lets you jumpstart customer journeys instantly. ### update_contact_profile Edit a contact's info, tags, or custom fields. Use this to keep your subscriber data accurate and organized. ### add_contact_to_list Put a new subscriber into a specific list. This makes it easy to move leads into the right buckets. ## Prompt Examples **Prompt:** ``` How did my last email campaign perform? ``` **Response:** ``` ### Campaign Performance Summary **Campaign:** Spring Promo (ID: c_987) | Metric | Value | | :--- | :--- | | **Open Rate** | 22% | | **Click-Through Rate** | 4% | | **Total Deliveries** | 1,200 | Would you like me to check for any bounced addresses or pull the full details for this campaign? ``` **Prompt:** ``` Add a new subscriber named Sarah Jenkins (sarah@example.com) to my 'Early Bird' list. ``` **Response:** ``` ✅ **Success!** I've added **Sarah Jenkins** (sarah@example.com) to your **Early Bird** list. Is there anything else you'd like me to do with this contact? ``` **Prompt:** ``` List all my current email lists. ``` **Response:** ``` I've retrieved your current email marketing lists: * **Weekly Newsletter** (ID: l_123) * **Product Updates** (ID: l_456) * **Lead Magnet** (ID: l_789) Which one would you like to manage? ``` ## Capabilities ### Add new subscribers to specific lists Put new leads into your mailing lists via natural language. ### Update contact profiles Modify tags or custom fields for your existing subscribers. ### Pull campaign performance metrics Get open and click rates for any past email blast. ### List active marketing lists See all your current subscriber segments at once. ### Trigger automated sequences Start specific onboarding flows for individual contacts. ### Remove contacts from lists Clean up your audience by deleting subscribers from specific lists. ### Get list metadata Retrieve detailed info about your email marketing lists. ## Use Cases ### Adding webinar leads to a warm list A growth marketer wants to add 50 new leads from a webinar to a 'Warm Leads' list. They ask the agent to use add_contact_to_list for each one. ### Quick campaign status check A manager needs a quick status update on the 'Summer Sale' campaign. They ask the agent to pull the summary using get_campaign_summary_report. ### Auditing a VIP list A business owner wants to see who is on the 'VIP' list. They ask the agent to use list_contacts_in_list to see the current count and status. ### Triggering an onboarding flow A marketer wants to start a specific onboarding flow for a new enterprise client. They tell the agent to use trigger_automation_for_contact for that specific lead. ## Benefits - You can pull campaign data instantly using get_campaign_summary_report to see what's working without navigating a dashboard. - Managing your audience becomes faster as you can use add_contact_to_list and update_contact_profile to keep your data current in real-time. - You save time on manual list management by using list_email_lists to quickly see your entire marketing structure. - Automation becomes easier with trigger_automation_for_contact, letting you start specific customer journeys via simple commands. - You get a clear view of your marketing health by using list_email_campaigns to see what's pending and what's already gone out. ## How It Works The bottom line is you get a hands-free way to manage your email marketing without ever opening the EmailOctopus dashboard. 1. Subscribe to the Connector and grab your API key from the EmailOctopus integrations page. 2. Connect the Connector to your preferred AI client like Claude or Cursor. 3. Ask your agent to perform actions like listing subscribers or pulling reports. ## Frequently Asked Questions **Can I use EmailOctopus MCP to manage my subscribers?** Yes, you can add, update, and remove subscribers from your lists using natural language. It makes managing your audience much faster than using the manual dashboard. **Does this EmailOctopus MCP work with my current lists?** It connects to your existing EmailOctopus account, so all your current lists and tags stay exactly where they are. The agent just acts as a new way to interact with them. **Can I see my campaign reports with this Connector?** You can pull performance summaries for any campaign, including open and click rates, directly through your agent. It's a great way to get quick stats during meetings. **Can I trigger automated workflows?** Yes, you can start specific automated sequences for individual contacts using the tool. This helps you trigger onboarding or follow-up flows immediately. **Is there a way to see all my campaigns?** You can ask your agent to list all your sent and draft campaigns to see what's been sent. It gives you a quick overview of your recent marketing activity. **Can I update a contact's info?** You can update profiles, including custom fields and tags, without opening the dashboard. This keeps your subscriber data organized and up to date. **How do I find my EmailOctopus API Key?** Log in to your account, navigate to **Integrations** > **API**, and click **Create Key** to generate your unique access token. **Can I update custom fields for a contact?** Yes! The `update_contact_profile` tool allows you to modify tags and any custom data fields associated with a subscriber. **How do I check the performance of a sent campaign?** Use the `get_campaign_summary_report` tool with a campaign ID to retrieve real-time metrics including open and click rates.