# EmailOctopus MCP for AI Agents AI Agent Connect > EmailOctopus MCP lets your AI agent manage email marketing campaigns, handle subscriber lists, and pull performance reports directly. It connects your AI client to your EmailOctopus account so you can check stats, find specific contacts, and audit your marketing volume without switching tabs. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_C91Q0dhzgxNbzRZGiOLrIM4er8Es7dLQNoUwsFUg/ai-agent-connect - **Tags:** emailoctopus, email-marketing, automation-api, subscribers-management, email-lists, campaign-reports, newsletter-automation, mcp ## Description Imagine you're in the middle of a marketing meeting and need to know exactly how many people opened last week's newsletter. Usually, you'd have to log in, find the right dashboard, and dig through filters. With this Connector, you just ask your AI client to pull the latest stats. It handles the heavy lifting of navigating your EmailOctopus account. You can check if a specific subscriber is still on your list, get a high-level audit of your total marketing volume, or see which campaigns actually hit the inbox. It turns your email marketing platform into a conversational workspace. It's one of the many ways Vinkius helps you connect your favorite tools to your daily workflow. You get to stop being a data entry clerk and start making decisions based on the numbers you need right now. ## Tools ### add_contact_to_list Add a new contact to a list ### create_email_list Create a new subscriber list ### remove_contact_from_list Delete a contact from a list ### get_contact_details Get details for a contact ### get_campaign_summary_report Get performance metrics for a campaign ### get_campaign_details View specific settings and status for an individual email campaign. This helps you keep track of campaign configurations. ### list_email_campaigns List every email marketing campaign you've created. Use this to quickly identify past and present marketing efforts. ### list_contacts_in_list Can filter by status. List contacts in a specific list ### list_email_lists List all subscriber lists ### trigger_automation_for_contact Requires API trigger to be enabled. Start an automation for a contact ### update_contact_profile Update an existing contact ### get_list_details See subscriber counts and organizational markers for a specific marketing list. It provides a clear view of your audience segments. ## Prompt Examples **Prompt:** ``` What was the click rate on the 'Welcome' email? ``` **Response:** ``` Here is the performance summary for the **Welcome** campaign: | Metric | Value | | :--- | :--- | | **Total Sent** | 5,450 | | **Opens** | 1,230 (22.5%) | | **Clicks** | 450 (8.2%) | | **Status** | Sent Would you like me to check which links were clicked most? ``` **Prompt:** ``` Is jane@example.com on the newsletter list? ``` **Response:** ``` I found **Jane** in your system: * **List:** Weekly Newsletter * **Status:** Subscribed * **Joined:** February 10th Should I pull her full profile and history for you? ``` **Prompt:** ``` Give me a quick audit of my marketing lists. ``` **Response:** ``` Here is a summary of your current marketing activity: * **Total Lists:** 3 active lists * **Recent Activity:** High engagement on 'Product Updates'. * **Volume:** Your 'Weekly Newsletter' is your largest segment with 5,500 subscribers. Do you want to see the specific subscriber count for any of these? ``` ## Capabilities ### Pull campaign performance metrics Get open and click rates instantly for any specific marketing blast. ### Search for specific subscribers Find a contact's profile and history using just their email address. ### Audit marketing volume Get a high-level summary of your list counts and campaign activity. ### Manage contact lists See every list in your account along with its subscriber counts. ### Inspect campaign settings View the specific details and status of any individual campaign. ## Use Cases ### Checking a promo A marketer asks for the click rate on the 'Summer Sale' email and gets the data instantly using get_campaign_performance_summary. ### Verifying a lead A sales rep wants to know if jane@example.com is on the VIP list and uses search_contacts_by_email to check her status. ### Audit check An ops lead needs a high-level summary of all lists to prepare for a quarterly report using quick_marketing_volume_audit. ### Campaign status check A manager wants to see which emails actually went out today and uses list_successfully_sent_campaigns to confirm. ## Benefits - Stop tab-switching by pulling campaign performance summaries directly into your chat using get_campaign_performance_summary. - Find subscribers faster by using search_contacts_by_email to locate specific profiles in seconds. - Get instant marketing audits with quick_marketing_volume_audit to see your total audience reach. - Verify list health by checking get_list_details for unsub counts and organizational markers. - Keep your outreach organized by using list_marketing_lists to see all your audience segments in one place. ## How It Works The bottom line is that you get direct, conversational access to your email marketing data without ever leaving your chat interface. 1. Get your API key from your EmailOctopus account settings. 2. Connect the Connector to your AI client via the Vinkius dashboard. 3. Ask your agent to check campaign stats or list your subscribers. ## Frequently Asked Questions **Can I use the EmailOctopus MCP to send out newsletters?** No, this Connector is designed for data retrieval and oversight. You can use it to check stats and find subscribers, but you should use the EmailOctopus web interface to actually send your emails. **How do I find a specific subscriber's history with EmailOctopus MCP?** You can ask your agent to find a person by their email address. It will pull their full profile, including their subscription status and join date. **Can the EmailOctopus MCP show me how many people unsubscribed?** Yes, you can ask the agent to show you the details of a specific list. It will provide the unsubscribe counts and other organizational markers for that list. **How do I connect my EmailOctopus account to my AI client?** You just need your API key from your EmailOctopus account settings. Once you have that, you can connect it through the Vinkius dashboard to give your agent access. **Can I see all my marketing lists at once with this Connector?** Yes, your agent can list every contact list in your account. This is a great way to get a quick overview of all your audience segments in one place. **Is this good for checking if my campaign was actually sent?** Yes, you can ask your agent to identify campaigns that have already been sent. It will quickly filter your account to show only the successful blasts. **How do I get an EmailOctopus API Key?** Log in to your EmailOctopus account, navigate to **Account > API**, and you can generate or retrieve your unique API Key from there. **Can the agent send new email campaigns?** This integration currently focuses on listing and auditing campaigns, lists, and contacts. Creating or sending new email campaigns should be managed via the EmailOctopus dashboard. **Does the integration show open rates?** Yes, you can use the get_campaign_performance_summary tool to retrieve specific counts for opens and clicks for any sent campaign. **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.