# Emma MCP > Emma MCP gives your AI agent full control over email marketing. Manage audience groups, analyze campaign performance, and update member lists directly from natural conversation. It lets you list all members, create new segments, or check response metrics for any mailing without touching the Emma UI. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-campaigns, audience-segmentation, subscriber-management, marketing-automation, email-analytics, list-management ## Description This MCP connects your account to Emma, giving your AI agent direct access to manage every aspect of your email marketing efforts. You can talk to it and tell it exactly what to do with your audience data. Need a list of all active subscribers? Just ask. Want to know if the last campaign worked? Get the open rates and click-through stats right away. It handles everything from listing custom member fields to creating entirely new segments for targeted blasts. You can also monitor which automations are running or check out your full mailing history, whether it was sent today or months ago. Because this connection is managed through Vinkius, you connect once and get this powerful marketing data access alongside dozens of other tools your company might need. ## Tools ### list_mailings Retrieves a complete list of all sent and scheduled email campaigns. ### list_members Fetches an exhaustive list of every individual on the mailing list. ### create_group Allows you to build and create a new, targeted member group within Emma. ### delete_group Safely deletes an existing, empty member audience group. ### get_mailing_stats Pulls specific performance metrics like opens and clicks for a given mailing ID. ### list_automations Lists and checks the status of all defined automated email workflows. ### get_member Retrieves all detailed profile data for one specific member email address. ### list_fields Displays every custom or standard data field available for members. ### list_groups Shows the names and status of all existing member groups in your account. ### list_webhooks Shows all active webhooks connected to your Emma account. ## Prompt Examples **Prompt:** ``` List all my audience groups in Emma. ``` **Response:** ``` I've retrieved your audience groups. You have 5 groups: 'Newsletter Subscribers' (Active), 'VIP Clients', 'Product Beta Testers', and 2 others. Shall I list the members for any of these groups? ``` **Prompt:** ``` Get details for member with email test@example.com. ``` **Response:** ``` I've found the profile for test@example.com. Their status is 'active', they joined on Jan 15th, and they are currently in the 'General' and 'Beta' groups. Would you like to see their custom field values? ``` **Prompt:** ``` What are the response stats for my latest mailing? ``` **Response:** ``` Retrieving stats for your latest mailing (ID: 12345)... It had a 25% open rate and 4% click-through rate. 12 members unsubscribed. Shall I provide more detail on the specific link clicks? ``` ## Capabilities ### Build Audience Segments The agent can create new member groups to segment your mailing list for highly targeted campaigns. ### Audit Member Data You can fetch detailed profiles on specific members, including their custom field values and current status. ### Analyze Campaign Performance It retrieves summary response metrics—like opens and clicks—for any past or scheduled mailing campaign. ### Review System Activity You can list all active webhooks, automated workflows, and custom data fields defined in the Emma account. ### Manage Group Structure The agent lets you view or delete existing audience groups to keep your subscriber base organized. ## Use Cases ### Need to clean up stale subscribers. A growth team needs to find all members who haven't interacted with the last five campaigns. They ask their agent to list the members, check their details using 'get_member', and then cross-reference that data against group sizes via 'list_groups' to build a clean segment for re-engagement. ### Investigating campaign failure. The marketing manager notices a drop in engagement. They ask their agent, 'What were the response stats for the Q2 product update?' The MCP runs 'get_mailing_stats' and immediately shows an open rate that is 15% lower than expected. ### Setting up new lead capture paths. A support agent needs to track a customer who called in. They ask the agent for the member details using 'get_member', verify their current groups, and then use 'create_group' to automatically enroll them into a specialized onboarding segment. ### Preparing for a major product launch. The team needs to know exactly who is eligible for early access. They ask the agent to list all members, check their custom fields using 'list_fields', and then run a report based on that data. ## Benefits - Stop clicking through dashboards. Instead of navigating multiple tabs to check campaign performance, you simply ask for the stats using 'get_mailing_stats' and get a direct answer. - Segmenting is faster than ever. Instead of manually building lists or guessing criteria, your agent can execute 'create_group', instantly segmenting thousands of members based on rules you provide. - Deep member insights are now available to your AI client. If you need to know if a user signed up last week and what their custom field values are, 'get_member' pulls it all in one go. - Keep track of system health instantly. Use 'list_webhooks' or 'list_automations' to verify that your critical background workflows didn't break overnight. - Never lose an audience group name again. You can get a full overview by running 'list_groups', giving you immediate context on your entire subscriber base structure. ## How It Works The bottom line is that you use natural language to execute complex, multi-step marketing operations without needing to navigate the Emma interface. 1. First, subscribe to this MCP on Vinkius and provide your Emma Account ID, Public API Key, and Private API Key. 2. Next, connect your preferred AI client—be it Claude or Cursor—to the catalog. Your agent now recognizes all available marketing tools. 3. Finally, tell your agent what you need; for example, 'List my mailing list members' or 'What were the stats for last month’s campaign?' and get instant data. ## Frequently Asked Questions **How do I check if a member is active with Emma MCP?** You use the 'get_member' tool. This allows you to pull a specific user's detailed profile, verifying their current status and join date directly through your AI agent. **Can I see all my groups using list_groups?** Yes, running 'list_groups' provides an immediate overview of every segment group you have created in Emma. This helps you audit your current audience structure quickly. **What data does get_mailing_stats provide for campaigns?** The 'get_mailing_stats' tool pulls key performance indicators (KPIs) like the open rate and click-through rate. It gives you the metrics needed to know if a campaign performed well. **Does Emma MCP only list existing groups?** No, besides listing them via 'list_groups', the MCP also lets you actively build new audience segments by running the 'create_group' tool when needed. **Is it possible to see custom fields with this MCP?** Absolutely. You can run 'list_fields' to see every standard and custom data field available, and then use 'get_member' to retrieve the values for a specific member. **How do I find my Emma API Keys?** Log in to your Emma account, click on your name in the top right, go to 'Account Settings', and then select 'API Key'. You will find your Account ID, Public Key, and Private Key there. **What is the difference between a group and a segment?** In Emma, a group is a static collection of members you've explicitly added. A segment is a dynamic group based on rules (like 'opened last email'). This server currently focuses on managing static groups. **Can I see my custom member data fields?** Yes! Use the `list_fields` tool to retrieve all standard and custom member data fields defined in your account.