# Loops MCP for AI Agents AI Agent Connect

> Loops MCP lets you manage your entire email marketing operation through your AI client. You can create and update contacts, manage mailing lists, and trigger automated journeys without leaving your chat interface. It handles transactional emails and checks suppression status, making it a direct way to run your Loops account using plain English.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_e5btDvlbhFFLMZRbD1LEFgO9lOMy5g6bqSbPUZkG/ai-agent-connect
- **Tags:** transactional-email, email-journeys, audience-segmentation, contact-management, marketing-analytics, suppression-lists

## Description

Imagine you're trying to get a new batch of users into a welcome sequence. Usually, you'd have to jump into a dashboard, find the right list, and manually trigger an event or check if their email is suppressed. With this Connector, you just tell your agent to do it. You can ask it to find a specific person, update their info, or add them to a list. It handles the heavy lifting of navigating the Loops interface for you. If you need to send a one-off transactional email, like a password reset or a receipt, you just give the details and let the agent handle the rest. It's part of the Vinkius catalog, which means you can plug this into your existing workflow and stop toggling between tabs. You're basically giving your agent a direct line to your email marketing infrastructure. Instead of copy-pasting IDs or hunting for buttons, you just talk. It handles the logic of finding the right contact, checking their status, and making sure the right message goes out.

## Tools

### create_contact
Adds a new user to your Loops account with their email and basic details.

### delete_contact
Removes a specific contact from your Loops account using their unique ID.

### find_contact
Locates a user's profile details based on their email address.

### get_contact_suppression
Checks if an email address is currently blocked from receiving messages.

### list_mailing_lists
Shows all available mailing lists you've created for subscribers.

### list_transactional_emails
Displays a history of recently sent transactional messages.

### send_event
Triggers specific email journeys by sending an event with a name and optional ID.

### send_transactional_email
Sends a one-off transactional email using a template and custom data variables.

### update_contact
Modifies existing contact fields like first name, last name, or user groups.

### test_api_key
Verifies that your Loops API key is active and correctly configured.

## Prompt Examples

**Prompt:** 
```
Find the user with email test@example.com and tell me if they are suppressed.
```

**Response:** 
```
I checked the status for **test@example.com** in Loops.

| Email | Suppression Status |
| :--- | :--- |
| test@example.com | **Not Suppressed** |

The user is active and ready to receive messages.
```

**Prompt:** 
```
Add a new contact named Sarah Jenkins with email sarah@work.com to the newsletter list.
```

**Response:** 
```
I've updated your Loops account with the following details:

*   **Name:** Sarah Jenkins
*   **Email:** sarah@work.com
*   **Action:** Added to the 'Newsletter' list.

Everything is set for her to receive future updates.
```

**Prompt:** 
```
Send a welcome event for newuser@example.com to start their journey.
```

**Response:** 
```
I've triggered the welcome journey for **newuser@example.com**.

*   **Event Sent:** `user-signed-up`
*   **Status:** Journey started successfully.

Your new user will receive the first automated email shortly.
```

## Capabilities

### Create and update contact profiles
Add new users to your account or modify existing details like names and user groups.

### Manage mailing list memberships
Discover available lists and add or remove subscribers from them.

### Trigger automated email journeys
Send specific events to start pre-configured email sequences for your users.

### Send transactional emails
Dispatch one-off messages like receipts or notifications using specific templates.

### Check email suppression status
Verify if an email address is blocked from receiving your messages.

### View transactional email history
Retrieve a list of recently sent transactional messages to track delivery.

## Use Cases

### Automating new user welcome flows
A user signs up on your site. You ask the agent to create_contact and then send_event to start their welcome journey immediately.

### Debugging missing transactional emails
A customer says they didn't get a receipt. You use get_contact_suppression to see if they are blocked and fix it instantly.

### Syncing CRM data to your mailing list
You have a new lead's details. Tell your agent to update_contact with the new info so your marketing stays current.

### Sending custom password resets
A user needs a manual reset. You use send_transactional_email with a template ID and the user's email to send it now.

## Benefits

- Stop manual data entry by using create_contact and update_contact to keep your database fresh without opening the dashboard.
- Get instant feedback on deliverability by checking suppression with get_contact_suppression to see why a user is missing emails.
- Automate user onboarding by triggering journeys with send_event based on real-time actions from your app.
- Quickly verify your connection status using test_api_key to avoid setup headaches and configuration errors.
- Keep track of outgoing messages easily by viewing the history with list_transactional_emails to confirm delivery.
- Organize your audience better by managing multiple lists via list_mailing_lists to ensure the right people get the right content.

## How It Works

The bottom line is you get a natural language interface for your entire Loops email marketing account.

1. Connect your Loops API key to the Connector via the Vinkius dashboard.
2. Tell your AI client what you want to do, like 'add this user to the newsletter'.
3. The agent executes the command and confirms the action is complete.

## Frequently Asked Questions

**Can the Loops MCP manage my email subscribers?**
Yes, it lets you add, update, and find contacts using natural language. You can keep your subscriber data fresh without leaving your AI chat.

**How do I trigger a specific email journey?**
You can ask your agent to send an event for a specific user. This will start the pre-configured journey you've built in Loops.

**Can I check if an email is blocked?**
Yes, you can ask the agent to check the suppression status of any email. It will tell you immediately if that user is blocked from receiving messages.

**Does this work for one-off emails?**
Yes, it handles transactional emails like receipts or password resets. Just tell your agent which template to use and who to send it to.

**How do I see my recent sent emails?**
You can ask your agent to list your recent transactional emails. It will show you a history of what was sent and when.

**Is it safe to delete contacts?**
Yes, you can ask the agent to delete a contact by their email. Just keep in mind that this action is permanent and cannot be undone.

**How do I get a Loops API key?**
Log in to your Loops account, go to **Settings** → **API**, and generate a new API key. Ensure it has the necessary permissions. Then provide it when prompted by the Connector setup.

**What operations are supported by this Connector?**
The server supports: testing API key validity, finding/creating/updating/deleting contacts, listing mailing lists, sending events to trigger email journeys, sending transactional emails, listing sent transactional emails, and checking contact suppression status.

**What is the difference between mailing lists and transactional emails in Loops?**
Mailing lists are used for marketing campaigns and automated email journeys. Transactional emails are one-off, triggered messages like receipts, password resets, or order confirmations. Both are supported by this Connector.

**How can I check if an email is suppressed in Loops?**
Use the 'get_contact_suppression' tool provided by this Connector. Simply ask the AI to check the suppression status for any email address, and it will tell you if that email is currently suppressed from receiving emails.

**What operations are supported by this MCP server?**
The server supports: testing API key validity, finding/creating/updating/deleting contacts, listing mailing lists, sending events to trigger email journeys, sending transactional emails, listing sent transactional emails, and checking contact suppression status.