Loops MCP. Manage contacts and trigger journeys programmatically.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Loops handles email marketing, transactional emails, and audience segmentation through one platform. Use this MCP Server to manage contacts, trigger automated journeys, send specific messages, and check who's suppressed—all via natural language commands.
What your AI agents can do
Create contact
Creates a brand new contact record in Loops, requiring an email address and allowing optional details like first name or last name.
Delete contact
Permanently removes a specific contact from Loops using their unique ID. Note that this action cannot be undone.
Find contact
Looks up and returns the full details for an existing contact within Loops by providing their email address.
Create, find, update, and delete individual user records using their email address or ID.
List all available mailing lists to ensure contacts are properly segmented for specific campaigns.
Send a trigger event that tells the platform to start an email workflow (like a welcome series) for a user.
Programmatically send critical, one-off messages like password resets or order confirmations using a template ID.
Check if an email address is suppressed, preventing the platform from sending mail to inactive or bounced addresses.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Loops MCP Server: 10 Tools for Marketing Automation
Use these ten specific tools to manage contacts, trigger events, and handle all communications within the Loops platform via natural language commands.
019d75cacreate contact
Creates a brand new contact record in Loops, requiring an email address and allowing optional details like first name or last name.
019d75cadelete contact
Permanently removes a specific contact from Loops using their unique ID. Note that this action cannot be undone.
019d75cafind contact
Looks up and returns the full details for an existing contact within Loops by providing their email address.
019d75caget contact suppression
Checks if a given email address is suppressed, confirming whether or not they should receive any emails from Loops.
019d75calist mailing lists
Retrieves a list of all available mailing lists configured in your account for segmentation purposes.
019d75calist transactional emails
Fetches a list of recently sent transactional emails, allowing you to limit the number of results returned.
019d75casend event
Triggers an automated email journey by sending a named event and optionally identifying the target user or recipient.
019d75casend transactional email
Sends a single, immediate transactional email using a specified template ID and optional variable data.
019d75catest api key
Runs a simple check to confirm that the provided Loops API key is valid and operational.
019d75caupdate contact
Modifies an existing contact record in Loops by ID, allowing you to change multiple fields like name or user group.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Loops, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You've got an AI agent that needs to handle customer comms? This server connects your agent straight to Loops, letting it manage everything from contact data to complex email journeys without you ever touching a dashboard. You control the entire lifecycle using natural language commands.
Managing Contacts and Data Status
You can keep track of every user record. To find out if a person exists, you just use find_contact with an email address, which returns all their current details. If that contact doesn't exist yet, you call create_contact, giving it the required email and optionally adding first or last names to build the record.
When data changes—like a user changing groups or updating their name—you use update_contact by specifying the target ID and listing all the fields you want to change. If that contact is garbage and needs deleting, you can permanently remove them using delete_contact; remember, this action's irreversible.
Before sending anything out, your agent must check if an address is eligible for mail; calling get_contact_suppression tells you immediately if the email has been flagged or bounced. This prevents sending messages to addresses that won't get seen.
Running Campaigns and Sending Messages
When you need to send a one-off, immediate message—say, a password reset link or an order confirmation—you use send_transactional_email. You provide the specific template ID and any variable data needed for that single email. If you're not sending a quick blast, but instead starting a complex workflow (like a welcome series), you send an event using send_event.
This triggers the platform to begin the automated journey for the specified user or recipient.
Segmentation and Utility Tools
You can’t segment people if you don't know what lists exist. To see all available groups, you run list_mailing_lists, which retrieves a list of every configured mailing list in your account. You also need to check the system itself; running test_api_key confirms that the API key your agent is using is valid and operational.
If you want to review recent communication activity, you can fetch a history of sent messages by calling list_transactional_emails, letting you limit how many results it returns. You have full control over contact records—you'll find tools to manage individual users via their ID or email address, check suppression status before mailing, and trigger complex journeys using event names.
How Loops MCP Works
- 1 First, check the contact's status using
find_contactand validate their suppression status withget_contact_suppression. This prevents failed sends. - 2 Next, use
update_contactto modify specific fields (like a user group or name) if necessary. You can also add them to a list vialist_mailing_listscontext. - 3 Finally, trigger the desired action: either sending an immediate email with
send_transactional_email, or starting a journey by callingsend_event.
The bottom line is that you move from natural language commands directly into reliable, multi-step marketing actions without manual UI interaction.
Who Is Loops MCP For?
This is for the Marketing Operations Specialist who spends hours clicking through dashboards just to update a contact's segment before a campaign runs. Or the Growth Engineer whose job involves building reliable, multi-step user onboarding flows in code.
Runs campaigns and manages audience segments. They use this to programmatically update contact records and initiate welcome journeys for new sign-ups.
Builds the backend logic for user onboarding flows. They rely on send_event and update_contact to ensure every step of the journey executes correctly based on data changes.
Needs to audit user activity or trigger specific communications (like a feature announcement email) when certain product milestones are hit. They use send_transactional_email for these one-off alerts.
What Changes When You Connect
- Eliminate manual checks. Before sending mail, use
get_contact_suppressionto confirm an email address is active. This prevents bounces and keeps your sender reputation clean. - Build complex flows easily. Instead of writing multi-step code, call
send_event. This triggers entire automated welcome or re-engagement journeys right away. - Save time on data cleanup. Use
find_contactto verify a user's current details before callingupdate_contact, ensuring you don't overwrite critical information accidentally. - Control every message sent. For one-off alerts (like password resets), use
send_transactional_email. This keeps those high-priority messages separate from marketing campaigns. - Audit your efforts instantly. Use
list_mailing_liststo see exactly which segments exist, and checklist_transactional_emailsto prove what was sent when.
Real-World Use Cases
Onboarding a new user
A user signs up. The agent first calls find_contact using the signup email. If successful, it uses update_contact to set their initial 'user-signed-up' status, and then immediately calls send_event with that event name. This triggers the full welcome series.
Cleaning up stale accounts
The task is to find all contacts from a specific user group who haven't been updated in three months. The agent uses find_contact iteratively, checks their status with get_contact_suppression, and calls delete_contact only on those confirmed inactive records.
Sending a campaign update
The marketing team needs to announce a new feature to all contacts in the 'VIP' segment. The agent first runs list_mailing_lists to get the ID, then calls update_contact for every member of that list to ensure they are marked as active before sending out the announcement.
Verifying a critical message send
A customer reports not receiving an order confirmation. The agent uses find_contact to locate the user, then calls list_transactional_emails, filtering by the date and template ID, proving that the system attempted delivery.
The Tradeoffs
Assuming data existence
Just trying to update a contact's name without first checking if the email address is valid or if the contact exists at all. This fails and leaves the user hanging.
→
Always start with find_contact using the email address. If that tool returns an error, don't proceed; instead, call create_contact. This handles both new and existing users.
Sending mail blind
Triggering a message without checking if the recipient is suppressed or bounced. This wastes sends, damages your sender reputation, and costs money.
→
Before calling send_event or send_transactional_email, you must call get_contact_suppression. Only proceed if that tool reports 'not suppressed'.
Ignoring list context
Calling an update on a contact but failing to confirm they belong to the correct mailing list. The message goes out, but nobody sees it because they're segmented incorrectly.
→
Use list_mailing_lists first to get all IDs. Then, use update_contact to explicitly add or remove the user from the required segment ID.
When It Fits, When It Doesn't
Use this server if your workflow requires managing a contact's full lifecycle—from initial creation (create_contact) through segmentation updates (update_contact) and eventual communication dispatch (events/emails). It’s perfect for systems that need guaranteed, multi-step process execution.
Don't use it if you just need to read raw data. If all you need is a list of all contacts without modifying any details, a general database lookup might be faster. Also, don't rely on test_api_key for actual work; only run that tool once at the start of your script to confirm connectivity.
If you are building an orchestration layer, treat these tools as sequential steps: Find -> Validate Status -> Update Data -> Trigger Action.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Loops. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manual marketing campaigns require jumping between three different tabs just to update a single user record.
Today, updating a contact means opening the CRM dashboard, finding the right user by email search. Then you jump to the segment tab to move them from 'Trial' to 'Paid,' and finally open the communication tool to manually trigger the welcome sequence. It’s slow, prone to clicks-and-misses, and requires copying IDs.
With this MCP server, your agent handles it all in one go. You simply tell it: 'Find user X, move them to list Y, then send the Z event.' The system runs the checks, updates the data, and triggers the flow—all without you ever leaving your code.
Send a transactional email with Loops MCP Server: Deliver critical messages instantly.
Without this server, sending an order confirmation or password reset requires manually finding the correct template ID and running it through a dedicated system. This is brittle; if the ID changes, your code breaks. It's high-risk manual work.
Now, you simply tell the agent: 'Send Order Confirmation for user X.' The server handles the specific call to `send_transactional_email`, ensuring the message gets delivered using the correct template and data variables every single time.
Common Questions About Loops MCP
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 MCP server setup.
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.
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 MCP server.
How can I check if an email is suppressed in Loops? +
Use the 'get_contact_suppression' tool provided by this MCP server. 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 happens if I use the `update_contact` tool with a contact ID that doesn't exist in Loops? +
The server immediately returns an error code indicating the specified contact ID is invalid or not found. This prevents your agent from attempting to update non-existent records, ensuring data integrity.
Are there rate limits when I use the `send_event` tool to trigger many automated journeys? +
Yes, Loops enforces standard API rate limiting based on your plan. If you exceed the allowed calls, you'll get a 429 error. Your agent should implement retries with an exponential backoff strategy.
How does the Loops MCP server handle large result sets when calling `list_mailing_lists`? +
The listing tools support optional limit and offset parameters. This mechanism allows your AI client to paginate through potentially thousands of entries without hitting timeouts or memory constraints.
What format must the data variables be when I call `send_transactional_email`? +
The data variables must be passed as a JSON string. This guarantees your agent correctly maps structured information—like user names or order totals—into the template's required placeholders.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Vadoo
Host and optimize video content for the web with AI-powered SEO, automatic subtitles, and engagement analytics for creators.
Agile CRM
Manage contacts, deals, and marketing campaigns in one place with a CRM built for growing sales teams.
Get a Newsletter
Send professional newsletters to your audience with an email platform that makes list management and campaign tracking simple.
You might also like
Icypeas
Lead generation and email verification via Icypeas API.
Authorize.net
Process cards, manage refunds, capture holds, and inspect settled transactions on Authorize.net directly from your AI agent.
Blockchain.com Data
Access real-time Bitcoin blockchain data via Blockchain.com — query blocks, transactions, and addresses directly from any AI agent.