Skip to main content
Loops is a modern email platform for SaaS companies. The Loops MCP server lets you manage contacts, mailing lists, and send transactional or event-triggered emails using natural language.

​
What Can It Do?

  • Manage contacts including create, update, find, and delete
  • Organize mailing lists and subscriber segments
  • Send event-triggered emails to automate communication flows
  • Send transactional emails with dynamic data variables
  • Retrieve contact properties for audience insights

​
Where to Use It

Add Loops as a tool to any agent. The agent can then interact with your email platform conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your Loops account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Loops tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Find a contact by email address”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
List Mailing ListsRetrieve all mailing lists with name, description, and privacy settings
Find ContactFind a contact by email address or user ID
Create ContactCreate a new contact with email and optional properties like name, source, and mailing list subscriptions
Update ContactUpdate or create a contact with new properties (requires email or userId)
Delete ContactDelete a contact by email address or user ID
List Contact PropertiesRetrieve contact properties, optionally filtered to custom properties only
Send EventSend events to trigger emails in Loops, identified by email or userId
Send Transactional EmailSend a transactional email with data variables and optional attachments
List Transactional EmailsRetrieve transactional emails with automatic pagination support

​
Example Prompts

Use these with your agent or in the Agent Node: Find a contact: 
Find the contact with email sarah@company.com
Create a contact: 
Create a new contact with email john@startup.io, first name John, last name Doe, and subscribe them to the Product Updates mailing list
Send an event: 
Send a "signup_completed" event for the contact with email new_user@example.com
Send a transactional email: 
Send the welcome email template to alex@business.com with the data variable company_name set to "Acme Inc"
List mailing lists: 
Show me all my mailing lists and their privacy settings

​
Troubleshooting

IssueSolution
Contact not foundVerify the email address or userId is correct
Action not completingCheck that you’ve authenticated with your Loops API key
409 Conflict errorThe contact already exists; use Update Contact instead of Create Contact
Unexpected resultsThe agent may chain multiple tools (e.g., finding a contact first, then updating). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Subscribe john@example.com to the Newsletter list” will find the contact first, then update their mailing list subscriptions. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Loops MCP server using your Gumloop credentials.