# Loops MCP > Loops manages everything related to email marketing and customer communication. This MCP lets your AI client handle contact records, segment mailing lists, trigger automated welcome journeys, and send critical transactional emails—all using natural language commands. It's for anyone who needs precise control over their audience data without logging into a dashboard. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** transactional-email, email-journeys, audience-segmentation, contact-management, marketing-analytics, suppression-lists ## Description Need to manage contacts or run email campaigns but hate jumping between tabs? This MCP connects your AI agent directly to Loops, giving you full command over your marketing database. You can tell your client exactly what you need: find a specific contact by email, update their user group, or check if they're suppressed from receiving mail. Beyond simple data tweaks, the system lets you initiate automated journeys with minimal effort. For instance, after a sign-up event, your agent can trigger that welcome sequence instantly. You can also send one-off transactional emails—like password resets or order confirmations—without ever touching an email template dashboard. This kind of deep connection is exactly what Vinkius provides; it lets any MCP-compatible client use this toolset to handle the entire lifecycle of a lead, from initial data capture to final campaign delivery. ## Tools ### create_contact Adds a brand-new record for a person, requiring an email address and optionally accepting their name or user group. ### delete_contact Permanently removes a specified contact from the Loops database using their unique ID. Remember this is irreversible. ### find_contact Searches for and returns all details about a specific person by providing their email address. ### get_contact_suppression Checks the Loops system to confirm if a given email address is flagged as suppressed, meaning they shouldn't receive mail. ### list_mailing_lists Displays every available mailing list you have set up in your account, allowing you to see who can subscribe. ### list_transactional_emails Retrieves a history of recently sent transactional emails, letting you track what went out and when. ### send_event Sends a trigger event to the system, which kicks off an entire automated email journey for a recipient. ### send_transactional_email Sends an immediate, specific transactional message using a defined template and any necessary variable data. ### test_api_key Runs a quick check to confirm that the connection key for Loops is valid and fully operational. ### update_contact Modifies any part of an existing contact record, such as changing their email or adding them to a new user group. ## Prompt Examples **Prompt:** ``` Find the contact with email user@example.com in Loops ``` **Response:** ``` I searched for the contact with email user@example.com in Loops and found it. Here are the contact details including subscription status and attributes. ``` **Prompt:** ``` Create a new contact in Loops with email newuser@example.com, first name John, and last name Doe ``` **Response:** ``` I created a new contact in Loops with the email newuser@example.com and name John Doe. The contact has been successfully added to your Loops account. ``` **Prompt:** ``` List all mailing lists in my Loops account ``` **Response:** ``` Here are all the mailing lists configured in your Loops account. You can use these lists to manage subscribers and send campaigns. ``` **Prompt:** ``` Send a transactional email with template txn_123 to customer@example.com ``` **Response:** ``` I sent the transactional email using template txn_123 to customer@example.com. The email has been queued for delivery. ``` **Prompt:** ``` Send a 'user-signed-up' event for email newuser@example.com to trigger the welcome journey ``` **Response:** ``` I sent the 'user-signed-up' event for newuser@example.com. This will trigger the welcome email journey in Loops. ``` ## Capabilities ### Manage Contact Data The AI agent can create new contacts, locate existing ones by email address, update details like names or user groups, and delete records when necessary. ### Check Communication Status It verifies if an email address is suppressed, ensuring you don't send communications to invalid or blocked addresses. ### Control Audience Segmentation You can list and manage your various mailing lists, keeping track of who belongs where for targeted campaigns. ### Automate Email Journeys The MCP triggers specific events in Loops, kicking off complex, multi-step automated email sequences (like welcome or onboarding series). ### Send Targeted Emails It sends out transactional emails using specific templates and custom data variables, perfect for receipts or alerts. ## Use Cases ### Onboarding New Users A user signs up via the website. Instead of waiting for an admin, the system detects this and calls `send_event` with a 'user-signed-up' event, immediately kicking off the three-email welcome journey. ### Cleaning Up Stale Leads The sales team needs to update all contacts who haven't logged in for 90 days. The agent finds them using `find_contact` and then uses `update_contact` to flag their user group as 'Inactive', preventing bad campaigns. ### Sending Critical Alerts A payment gateway fails, requiring immediate notification. Instead of logging into the platform, the agent executes `send_transactional_email` with the specific order ID and error message to the customer. ### Preparing for a Campaign Launch Before sending an announcement, you need to verify which contacts are eligible. The agent runs `list_mailing_lists` first, then uses `get_contact_suppression` on key leads to ensure clean targeting. ## Benefits - Instantly manage data hygiene. Use the `find_contact` tool to verify a lead's current status, and if details are stale, use `update_contact` before running any campaign. - Execute complex workflows with zero clicks. Instead of manually clicking 'Send Welcome Email,' simply tell your agent to run `send_event`, triggering the entire journey sequence automatically. - Maintain compliance and deliverability. Before sending anything, your agent checks for suppression status using `get_contact_suppression` to ensure you never hit a dead end or spam trap. - Handle high-volume alerts easily. The ability to send transactional emails via `send_transactional_email` means critical messages—like billing failure notices—go out immediately, without needing manual intervention. - Build complex segmentation logic. By combining `list_mailing_lists` with contact lookups, your agent can determine exactly which groups need to receive a specific campaign update. ## How It Works The bottom line is, your AI client handles all the API calling; you just talk to it like you're talking to a colleague who knows your marketing stack inside and out. 1. You prompt your AI client with a natural language command, specifying the action (e.g., 'Find John Doe's contact'). 2. The MCP translates that request into the appropriate tool call and executes it against the Loops platform. 3. Your agent receives the data—whether it's a list of contacts or confirmation that an event was triggered—and presents the result back to you. ## Frequently Asked Questions **Can Loops MCP handle basic contact list operations?** Yes. You can use the `list_mailing_lists` tool to see all available lists and manage your audience segmentation using tools like `create_contact` or `update_contact`. **How do I trigger a welcome sequence with Loops MCP?** You use the `send_event` tool. By specifying the required event name and the recipient's email, your agent tells Loops to start the automated journey immediately. **Is sending transactional emails easy with Loops MCP?** It is straightforward. You call `send_transactional_email` and provide the template ID and any custom variables needed for that specific message, like an order number or receipt total. **What if I need to verify a contact's status before mailing them?** You should use `get_contact_suppression`. This tool checks the system first and tells you immediately if that email address is suppressed, saving you from sending bounce emails. **Can I change a user's group using Loops MCP?** Absolutely. Use `update_contact` and pass in the contact ID along with the new field values you want to change, like changing their userGroup or last name.