# EmailOctopus MCP > EmailOctopus MCP connects your AI agent directly to a professional email marketing platform. Use this connector to manage subscriber lists, track campaign performance in real time, and get deep insights into contact profiles without logging into the web dashboard. It turns complex reporting tasks—like checking open rates or finding specific contacts—into simple conversation commands. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** campaign-management, subscriber-lists, email-analytics, newsletter, marketing-automation, audience-segmentation ## Description This MCP lets your AI client handle all your email marketing operations using natural language. Instead of jumping through multiple dashboards to check stats, you ask your agent what you need. You can list every campaign you've run and retrieve detailed performance data instantly, like open counts or click rates. It also gives you visibility into your subscribers; for example, it lets you search for a specific contact by email address or pull their full profile history. Need to know how big your lists are? The agent handles that too. All this marketing intelligence gets piped directly through Vinkius, keeping your workflow centered on conversation. You can audit your entire operation from one place and understand the current status of both your lists and campaigns. ## Tools ### get_campaign_performance_summary Retrieves the key metrics like open rates and clicks for an already run email campaign. ### get_campaign_details Provides all the setup information, including sender details, for a specific campaign. ### get_contact_profile Gathers comprehensive data and history for one specific contact in your system. ### get_list_details Reports on the size of a list, including how many contacts are currently subscribed or have unsubscribed. ### quick_marketing_volume_audit Pulls a quick summary showing activity across multiple lists and campaigns at once. ### list_marketing_lists Generates a list of every marketing list you have set up in your account. ### list_email_campaigns Displays all the email campaigns that exist within your EmailOctopus account. ### list_list_contacts Shows a roster of every contact member belonging to one specific marketing list. ### list_successfully_sent_campaigns Identifies and lists all the campaigns that have already been delivered to your subscribers. ### search_contacts_by_email Finds a specific contact within any list just by providing their email address. ## Prompt Examples **Prompt:** ``` List all my marketing lists. ``` **Response:** ``` I've found 3 lists, including 'Product Updates' (1,200 subscribers) and 'Weekly Newsletter' (5,500 subscribers). Would you like to see the details for the Weekly Newsletter? ``` **Prompt:** ``` Show me the performance report for campaign 'Q1 Promo'. ``` **Response:** ``` Campaign 'Q1 Promo' was sent to 5,450 recipients. It has 1,230 opens (22.5%) and 450 clicks (8.2%). Status is 'Sent'. Should I check which links were clicked the most? ``` **Prompt:** ``` Search for contact 'jane@example.com' in the Weekly Newsletter list. ``` **Response:** ``` Jane is a member of 'Weekly Newsletter' and is currently 'Subscribed'. They joined on February 10th. Should I pull their complete field data? ``` ## Capabilities ### Check campaign performance Retrieve summarized metrics like opens, clicks, and sends for any specific email campaign. ### Manage subscriber lists List all marketing lists available in your account or get detailed counts of subscribers and unsubscribed contacts within a list. ### Audit organizational activity Get high-level summaries about both campaign activity and overall list volumes instantly. ### Research contact data Search for an individual subscriber using their email address or retrieve their full profile history and status. ### View campaign settings Pull the specific setup details for any existing email marketing campaign. ## Use Cases ### Investigating a low open rate The marketing manager asks, 'Why did the Q3 promo campaign underperform?' The agent uses `get_campaign_performance_summary` to pull detailed stats showing exactly which metrics—opens, clicks, or sends—need attention so the manager can adjust the next send. ### Auditing list growth The operations lead asks for an overall health check. The agent runs `quick_marketing_volume_audit` to provide a high-level view of all active lists and recent campaign activity, proving the mailing program is healthy. ### Targeting a specific client The CRM specialist needs details on a key contact. They ask the agent to `search_contacts_by_email` for 'john@client.com' and immediately get John's full profile and subscription status. ### Comparing list sizes The content team wants to know which audience segment is biggest. They ask the agent to `list_marketing_lists` first, then use `get_list_details` on a few key lists to compare subscriber counts quickly. ## Benefits - Stop manually checking performance reports. Use the `get_campaign_performance_summary` tool to instantly pull open rates and click counts for any campaign you run. - Get a full picture of your audience with the `quick_marketing_volume_audit`. This single action lets you see list sizes and overall activity without jumping between tabs. - Need to segment an audience? The agent can use `search_contacts_by_email` or `list_list_contacts` to pull targeted groups based on specific emails. - Never lose context again. Use `get_contact_profile` to review a subscriber's complete history, right inside your conversation window. - Keep track of everything you've done with `list_email_campaigns`. This lets you quickly see what campaigns are available for review or updates. ## How It Works The bottom line is that it lets you treat complex marketing analytics like simple chat commands. 1. Connect your AI client to this MCP and authorize access using your EmailOctopus API Key. 2. Tell your agent what you need—for instance, 'Show me the performance report for Q2 promotions.' 3. The agent calls the necessary tool, retrieves the data, and presents a readable summary right in your conversation. ## Frequently Asked Questions **How does EmailOctopus MCP help with audience segmentation?** You use the agent to list all contacts in a specific group using `list_list_contacts`. You can also search for individuals by email address using `search_contacts_by_email` before segmenting. **Can I check campaign stats for last month with EmailOctopus MCP?** Yes. The agent uses `get_campaign_performance_summary` to retrieve historical performance metrics, so you don't have to rely on old exports. **Does EmailOctopus MCP show me all my lists?** Absolutely. Use the `list_marketing_lists` tool when you need a complete rundown of every list set up in your account. **What if I want to know about campaign volume generally? Does EmailOctopus MCP support that?** The agent can run `quick_marketing_volume_audit`. This tool provides a high-level summary of list and campaign activity across your entire account.