# Loops.so MCP

> Loops.so helps you manage all your email marketing and transactional messages directly from your AI client. It lets you handle contacts, create campaigns, send automated emails, and check deliverability status without leaving your chat window.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** email-campaigns, transactional-email, contact-management, marketing-tools, saas-automation

## Description

Managing email communications used to mean switching between a CMS, a spreadsheet, and a dedicated sending platform just to get one job done. Now, you can tell your AI client what you need—like creating a new mailing list or checking if a contact is suppressed—and it handles the connection to Loops.so for you. You can find contacts by email, update their subscription status, and even create brand-new campaign structures using natural language commands. Need to test an automated welcome email? Just ask your agent to send a transactional message right away, or list all available components to see what templates you have. If you're used to complex, multi-step processes that involve multiple logins, this MCP changes the game. It lets your AI client interact with everything from contact records to IP addresses, giving you full control over both marketing and automated messaging. You can manage it all through Vinkius's catalog of services.

## Tools

### check_api_key
Verifies if your provided Loops API key is valid for use.

### check_suppression
Checks the suppression status to see if a contact can receive marketing emails.

### create_campaign
Builds and initiates a new email campaign within Loops.so.

### create_contact_property
Adds a new custom data field (property) to the contact record.

### create_contact
Creates an entirely new user profile in your Loops account.

### delete_contact
Removes a specified contact from the system.

### find_contact
Locates an existing user using their email address or unique ID.

### get_campaign
Retrieves all specific details for a single, named campaign.

### get_component
Fetches the structural data for a specific email component (like a header or footer).

### get_email_message
Retrieves details about an existing, saved email message template.

### get_theme
Gets the structural and visual data for a specific email theme.

### list_campaigns
Provides a list of every active campaign you have set up.

### list_components
Lists all available, reusable email components in your account.

### list_contact_properties
Shows a list of every custom property you can add to contacts.

### list_ips
Lists all dedicated IP addresses used for sending emails.

### list_mailing_lists
Retrieves a list of every mailing list currently maintained.

### list_themes
Lists all saved email themes available for use in campaigns.

### list_transactional_emails
Retrieves a list of standard, non-marketing transactional message templates.

### remove_suppression
Manually removes suppression status for a contact, allowing them to receive emails again.

### send_event
Sends a specific event record to Loops.so to trigger automation workflows.

### send_transactional_email
Immediately sends an automated, non-marketing email using a predefined template.

### update_campaign
Modifies the settings or content of an existing campaign.

### update_contact
Changes details for an existing contact, or creates one if it doesn't exist yet.

### update_email_message
Modifies the content of a saved email message template.

## Prompt Examples

**Prompt:** 
```
Find the contact with email 'growth@company.com' and show their details.
```

**Response:** 
```
I've located the contact. Name: Alex Rivera, Status: Subscribed, Source: API. They are currently in the 'Early Adopters' user group.
```

**Prompt:** 
```
Send a transactional email to 'user@example.com' using the 'welcome-onboarding' transaction ID.
```

**Response:** 
```
Transactional email sent successfully to user@example.com using the 'welcome-onboarding' template.
```

**Prompt:** 
```
List all my active mailing lists and current campaigns.
```

**Response:** 
```
You have 3 mailing lists: 'Main Newsletter', 'Product Updates', and 'Beta Testers'. I also found 2 active campaigns: 'Black Friday 2024' and 'Monthly Digest'.
```

## Capabilities

### Manage Contact Records
You can create new contacts, find existing users by email or ID, update their personal details, or delete records entirely.

### Control Mailing Lists and Campaigns
The MCP lets you list all active campaigns, retrieve specific campaign details, or build a brand-new marketing initiative from scratch.

### Handle Messaging and Templates
Send automated transactional emails using templates, get details on existing messages, or update components that make up your email structure.

### Maintain Deliverability Status
Check if a contact is suppressed from receiving emails, remove suppression status when appropriate, and list dedicated sending IPs for compliance checks.

### Automate User Actions
Trigger specific events for contacts or create new custom properties to power your automation workflows based on user behavior.

## Use Cases

### A Lead Needs to Be Added Post-Webinar
The sales team just got a list of new webinar attendees. Instead of manually entering each email, the agent runs 'create_contact' for every person and immediately uses 'update_contact' to set their industry and job title, prepping them for follow-up.

### Campaign Testing Before Launch
The marketing lead wants to verify a new template. They ask the agent to list all available components using 'list_components', then use 'get_email_message' to pull up the specific message they want to test, confirming everything works before sending it out.

### Fixing Old Contact Data
A user complains that a contact hasn't received an important update. The agent first runs 'find_contact' to verify existence, checks the suppression status with 'check_suppression', and if appropriate, uses 'remove_suppression' before notifying the sender.

### Tracking User Behavior for Segmentation
When a user performs an action on the site (like viewing pricing), the agent is instructed to run 'send_event', which records that event in Loops.so, allowing the system to automatically power up future automation workflows.

## Benefits

- Stop switching tabs. You can manage contact details—creating new users or updating properties—and check campaign status all in one chat session, eliminating the need to open multiple dashboards.
- Testing is fast. Instead of going into a separate environment, you just ask your agent to send a transactional email using 'send_transactional_email' for instant QA testing.
- Keep your emails deliverable. You can check suppression status with 'check_suppression' and even use 'remove_suppression' when a user's relationship warrants it—all without logging into the sending platform.
- Build campaigns faster. List all mailing lists with 'list_mailing_lists' or get detailed reports on specific campaigns using 'get_campaign', giving you immediate visibility into your outreach efforts.
- Automate everything. By calling 'send_event' and managing custom properties via 'create_contact_property', you can trigger complex user workflows without writing any code.

## How It Works

The bottom line is that your AI client speaks the language of email marketing platforms, letting you skip the manual dashboard navigation entirely.

1. First, subscribe to this MCP and provide your Loops API key credentials.
2. Next, tell your AI client exactly what you need—for instance, 'Find the details for john@example.com.'
3. The agent executes the request against Loops.so and delivers the contact information or campaign status directly in the chat.

## Frequently Asked Questions

**How do I find a user's information using Loops.so MCP?**
You use the 'find_contact' tool by providing their email or unique ID to your agent. It returns the contact's full profile, including their current subscription status and group memberships.

**Can I test an email message with Loops.so MCP?**
Yes. You can use 'get_email_message' to review a template or 'send_transactional_email' to send a live, automated test message directly from the chat.

**What is suppression status in Loops.so MCP?**
Suppression control tracks whether a contact is blocked from receiving marketing emails. You can use 'check_suppression' and 'remove_suppression' to manage this critical deliverability setting.

**How do I update a user's details with Loops.so MCP?**
The agent uses the 'update_contact' tool. You just tell it what change you need, like updating a job title or mailing list subscription status, and it executes the write operation.

**Does Loops.so MCP handle campaign creation?**
Yes, you can kick off new initiatives by using 'create_campaign'. This tool lets you build out the framework for a major marketing push directly through your AI agent.