# Cakemail MCP > Cakemail manages your entire email marketing operation—from list building to campaign analytics—all through conversation. List all contact lists, create new campaigns, add subscribers, and check performance logs directly with any AI agent. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-marketing, contact-management, campaign-analytics, subscriber-lists, bulk-email ## Description You can run complex marketing tasks without ever opening the Cakemail dashboard. This MCP lets you manage subscriber lists, build entire email campaigns, and track how well they perform using just natural language chat. Need to know your current customer count? Just ask. Want to check if a campaign hit its send date? Done. It handles everything from listing all existing contact groups to retrieving detailed analytics logs. Plus, you can actively add new subscribers right into the conversation. You'll find this MCP on Vinkius, giving your AI client access to thousands of other tools so you can manage more than just email marketing in one place. ## Tools ### create_campaign Creates and sets up an entirely new email campaign for your audience. ### create_contact Adds a single, specific contact to one of your existing lists. ### create_contact_list Sets up and names a brand new, dedicated contact list group. ### get_account_info Pulls your core profile data and general account settings for review. ### get_analytics Retrieves the most recent performance logs to monitor campaign success rates. ### get_campaign Fetches detailed information about one specific email campaign by its ID. ### get_contact_list Gets all the metadata for a single, specified contact list. ### list_campaigns Lists every campaign you've created and gives details like subjects and statuses. ### list_contacts Lists every contact currently inside a specific, targeted list. ### list_contact_lists Provides a complete overview of all contact lists you manage. ## Prompt Examples **Prompt:** ``` List all my contact lists in Cakemail. ``` **Response:** ``` I've retrieved your lists. You have 3 active lists: 'Newsletter' (ID: list_1), 'Customers' (ID: list_2), and 'Leads' (ID: list_3). ``` **Prompt:** ``` Show the last 5 email campaigns. ``` **Response:** ``` Retrieving campaigns... Your 5 most recent campaigns include 'March Sale' (Sent), 'New Product Launch' (Draft), and 'Weekly Recap' (Scheduled). ``` **Prompt:** ``` Add john.doe@example.com to the 'Newsletter' list. ``` **Response:** ``` Contact 'john.doe@example.com' has been successfully added to your 'Newsletter' list in Cakemail. ``` ## Capabilities ### List all contact groups Retrieves a full list of every contact list and its basic metadata. ### Create new campaigns Builds and publishes an entirely new email campaign using conversation commands. ### Add subscribers to lists Adds specific contacts or email addresses directly into your existing contact lists. ### Check campaign status Gets detailed information on a specific campaign, like its subject line and current status. ### View performance reports Retrieves recent analytics logs to see how well your campaigns are performing. ### Retrieve account settings Accesses core profile data and general account information without navigating menus. ## Use Cases ### Running a follow-up blast after a webinar The marketing lead needs to send an immediate thank you email. They ask the agent to `list_contact_lists` first to confirm the 'Webinar Attendees' group exists, and then use that list ID to run `create_campaign`. Finally, they track the results using `get_analytics`. ### Segmenting leads based on initial engagement A business owner wants to isolate high-value prospects. They ask the agent to check existing groups via `list_contact_lists`, then use `list_contacts` to pull out all users who opened the last three emails, and finally send a personalized pitch campaign using `create_campaign`. ### Debugging old campaigns A developer needs historical data on why an old campaign failed. They use the agent to check the status of the specific campaign ID via `get_campaign`, then pull up the details for that list using `get_contact_list` to see who was targeted. ### Onboarding a new client base A sales team needs to add 50 new leads. They first use `create_contact_list` to make the 'New Leads' segment, then they run `create_contact` fifty times in sequence, and confirm everything worked by asking for `list_contacts`. ## Benefits - Build a campaign in minutes. You can use the `create_campaign` tool to generate and launch new emails without ever leaving your agent interface. - Keep your audience clean. If you spot an error or need more people in a group, use the `list_contacts` tool first, then add them using `create_contact`, all in one flow. - Always know where you stand. The `get_analytics` tool lets you pull performance reports instantly, so you never miss checking conversion rates. - Build out your data structure easily. Need a new segment? Use `list_contact_lists` to see what's there, and then use `create_contact_list` to add the next one. - Deep dive into details. Instead of scrolling through dozens of settings, you can ask for specific information about an account using `get_account_info`. - Full campaign visibility. The `list_campaigns` tool gives you a quick overview of everything sent and drafted. ## How It Works The bottom line is that you get to manage your entire marketing stack by chatting with your AI agent instead of clicking through dashboards. 1. Subscribe to this MCP and provide your Cakemail API Token (Bearer). 2. Ask your AI agent a question, like 'List all my contact lists.' 3. The MCP runs the necessary function, pulls the data, and presents it back in plain text for you to use immediately. ## Frequently Asked Questions **How do I list all my contact lists using list_contact_lists?** You ask the agent, 'List all contact groups.' The MCP runs `list_contact_lists` and returns a full overview of every segment you manage. **Can I get details on a specific campaign using get_campaign?** Yes. You just give the agent the Campaign ID, and it uses `get_campaign` to retrieve all the detailed metadata for that single campaign. **Is there an easy way to add new people? (create_contact)** Sure thing. To add someone, you tell your agent to use `create_contact`, specifying their email and which list they should go into. **How do I check my performance logs after a send? (get_analytics)** You ask the agent to pull the analytics. It runs `get_analytics` and gives you recent metrics, so you know right away if your campaign worked. **When should I use the `create_campaign` tool if I'm building a complex sequence?** You run `create_campaign` when you need to initiate a new campaign shell. Remember, this MCP focuses on creation; for multi-step sequences, check Cakemail's native workflow tools after generating the initial draft. **How can I verify my credentials or check basic details using `get_account_info`?** The `get_account_info` tool returns core account settings and general profile data. This is useful for quickly confirming your connection status or checking global subscription limits without diving into specific campaign details. **If I only want to see contacts matching certain criteria, can I filter them using `list_contacts`?** Yes, the `list_contacts` tool accepts parameters for filtering. You can specify fields like region or status directly in your prompt to narrow down the results instead of retrieving every single contact. **If I need a new list, must I use `create_contact_list` before running other tools?** It's best practice. If you run `create_contact_list`, the tool confirms the list ID immediately. You then pass that specific ID to subsequent calls like `list_contacts` to ensure data integrity. **Can I check the total number of contacts in a list using the agent?** Yes! Use the `get_contact_list` tool with the List ID. Your agent will fetch the detailed metadata, which includes the `total_contacts` field for that specific list. **How do I add a new contact to an existing list?** Simply ask the agent to `create_contact` and provide the List ID and the email address. The contact will be added to your Cakemail list instantly. **Does the integration allow creating a new campaign?** Yes. Use the `create_campaign` action and provide the name and subject. Your agent will create the campaign in your Cakemail account, allowing you to finalize the content later.