# Envoke Marketing MCP MCP > Envoke Marketing connects your AI agent directly to email campaigns, contact lists, and performance metrics. You can list all ongoing campaigns, check individual subscriber profiles, and pull real-time stats like open rates and click counts—all through natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-campaigns, subscriber-management, performance-analytics, contact-lists, marketing-ops, communication ## Description Need to run a marketing diagnosis without opening 12 different tabs? This MCP gives your agent full access to Envoke’s engine room. You can manage entire email campaigns, track who opened what, and see exactly which segments are underperforming. Instead of wading through dashboards, you just ask. For example, you can pull the current status of a campaign or look up an individual contact's entire history in one chat session. It keeps your marketing operations running smoothly, no matter where your AI client is connecting from. Connect this MCP via Vinkius to get a single source of truth for all your email outreach and audience data. ## Tools ### get_envoke_account_metadata Retrieves important data like usage limits and overall health metrics for your Envoke account. ### get_campaign_performance_stats Pulls performance numbers, like opens and clicks, for an already run campaign. ### get_campaign_details Retrieves specific settings and current status details for a single email campaign. ### get_contact_profile Gets the full history and details for any individual contact in your system. ### quick_marketing_volume_audit Generates a quick, high-level summary of list counts and general campaign activity volumes. ### list_contact_address_lists Shows a list of all the segmented mailing lists configured within your account. ### list_email_campaigns Lists every email marketing campaign available in your Envoke account. ### list_marketing_contacts Pulls a list of all contacts currently registered in the organization's system. ### list_successfully_sent_campaigns Identifies and lists campaigns that have already been successfully distributed to subscribers. ### search_contacts_by_email Finds a specific contact record using only their email address. ## Prompt Examples **Prompt:** ``` List all active marketing campaigns. ``` **Response:** ``` I've found 5 active campaigns, including 'Monthly Newsletter' and 'Q2 Lead Magnet'. The Monthly Newsletter has already been sent to 3,500 contacts. Would you like to see the performance stats? ``` **Prompt:** ``` Show me the performance for campaign ID 12345. ``` **Response:** ``` Campaign ID 12345 has 3,500 sends, 850 opens (24.3%), and 240 clicks (6.8%). Status is 'Completed'. Should I check for any delivery bounces? ``` **Prompt:** ``` Search for contact 'alex@example.com'. ``` **Response:** ``` Alex is currently 'Subscribed' and a member of 2 lists: 'General Announcements' and 'Product Beta'. Their last recorded click was on March 15th. Should I pull their full interaction history? ``` ## Capabilities ### Analyze campaign performance Retrieve live metrics like open counts, click-through rates, and send volumes for any given campaign. ### Manage contact segments See all active mailing lists, search for specific contacts by email, or pull deep historical data on a single subscriber. ### Audit account health Retrieve high-level summaries of list sizes and check your Envoke account limits and metadata. ## Use Cases ### Campaign review for a new product launch The manager asks: 'List all active campaigns and check performance.' The agent uses `list_email_campaigns` then runs `get_campaign_performance_stats` on the top three. It tells them which one has high opens but low clicks, suggesting copy changes. ### Troubleshooting a specific lost customer A specialist needs to know why 'Jane Doe' hasn't opened an email. They ask for her profile; the agent uses `get_contact_profile` and tells them she was last active on a completely different product line. ### Quarterly audit of list health The ops team needs to verify all segments are accounted for. They run `list_contact_address_lists` and then use `get_envoke_account_metadata` to ensure the account hasn't hit any sending limits. ## Benefits - Stop guessing about performance. You can immediately check campaign results using `get_campaign_performance_stats` to see exact open rates, click counts, and send volume. - Drill down on specific subscribers. Instead of looking at aggregated reports, you use `get_contact_profile` to pull a full, deep history for any single person. - Keep track of your audience segments. You can list all mailing groups with `list_contact_address_lists` and see exactly who belongs where. - Audit everything in one go. Need an overview? Run the `quick_marketing_volume_audit` tool to get a high-level count of lists and campaigns without needing complex queries. - Find people fast. If you only have an email address, use `search_contacts_by_email` to pull up the full contact record right away. ## How It Works The bottom line is, you talk to your AI client, and it does the heavy lifting across all your marketing systems. 1. Connect this MCP to your AI client using your Envoke API ID and Key. 2. Ask your agent a direct question, like 'What were the open rates for last week's newsletter?' 3. Your agent invokes the necessary tools, pulling real-time data and presenting it as a natural conversation. ## Frequently Asked Questions **How do I list all my active campaigns with the `list_email_campaigns` tool?** Running `list_email_campaigns` shows you every campaign available in your account. You can then use `get_campaign_details` to pick one and see its specific setup details. **Does the MCP help me find a contact using only an email address? (Using `search_contacts_by_email`)** Yes, `search_contacts_by_email` quickly finds any record based on its email. Once found, you can use `get_contact_profile` to see their full history. **What is the difference between campaign listing and performance stats?** Listing campaigns (`list_email_campaigns`) just shows titles and status. You must use `get_campaign_performance_stats` to get actual metrics like open rates, sends, and clicks. **Can I check my account limits before sending a big blast? (Using `get_envoke_account_metadata`)** Yes. Using `get_envoke_account_metadata` lets you pull your current usage and defined quotas for Envoke, stopping you from running into unexpected sending blocks. **How do I pull a full history and all custom details for one person using the `get_contact_profile` tool?** It pulls everything about that contact. You get their full profile, interaction history, and any custom field values recorded in Envoke. This is great for deep audience research. **Before I segment users, how do I see all possible list names using `list_contact_address_lists`?** It returns a complete inventory of every contact list configured in your account. You can use these lists to accurately target specific groups for campaigns. **How do I confirm which campaigns have already finished sending using the `list_successfully_sent_campaigns` tool?** This tool provides a list of campaigns that completed their send cycle. Use it to verify deployment status and ensure no critical blast was missed. **What is the fastest way to check overall list sizes and activity using `quick_marketing_volume_audit`?** It gives you a high-level snapshot of both your total list volume and recent campaign activity. This lets you quickly assess organizational health without running multiple reports. **How do I get Envoke API credentials?** Log in to your Envoke account, navigate to **Settings > API Integration**, and you can find your unique **API ID** and **API Key** there. API access is typically included in professional and higher plans. **Can the agent send new mass emails?** This integration currently focuses on listing and auditing campaigns, lists, and contacts. Creating or sending new mass emails should be managed via the Envoke platform dashboard or automated API triggers. **Does the integration show real-time stats?** Yes, you can use the get_campaign_performance_stats tool to retrieve the latest sent, open, and click counts for any active campaign.