Loops MCP by usefulapi

Working · 484 ms

io.usefulapi/loopsv1.21.0 Domain verified

Manage Loops contacts, mailing lists, and transactional/event emails.

Marketing & SEO Communication

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://loops.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

loops_create_contact Destructive

Creates a contact in Loops (additive). Loops API: POST /v1/contacts/create.

emailstring, required

Contact email address (required).

sourcestring

Source label for where the contact came from.

userIdstring

Your app's user id for this contact.

lastNamestring

Last name.

firstNamestring

First name.

userGroupstring

User group segment name.

propertiesobject

Arbitrary custom contact properties (string/number/boolean); merged into the request body.

subscribedboolean

Whether the contact is subscribed to email.

mailingListsobject

Map of mailing-list id -> subscribed boolean.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (10)

loops_create_contact

Creates a contact in Loops (additive). Loops API: POST /v1/contacts/create.

destructive

Argument	Type	Description
email*	string	Contact email address (required).
source	string	Source label for where the contact came from.
userId	string	Your app's user id for this contact.
lastName	string	Last name.
firstName	string	First name.
userGroup	string	User group segment name.
properties	object	Arbitrary custom contact properties (string/number/boolean); merged into the request body.
subscribed	boolean	Whether the contact is subscribed to email.
mailingLists	object	Map of mailing-list id -> subscribed boolean.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Contact email address (required)."
    },
    "source": {
      "type": "string",
      "description": "Source label for where the contact came from."
    },
    "userId": {
      "type": "string",
      "description": "Your app's user id for this contact."
    },
    "lastName": {
      "type": "string",
      "description": "Last name."
    },
    "firstName": {
      "type": "string",
      "description": "First name."
    },
    "userGroup": {
      "type": "string",
      "description": "User group segment name."
    },
    "properties": {
      "type": "object",
      "description": "Arbitrary custom contact properties (string/number/boolean); merged into the request body.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "subscribed": {
      "type": "boolean",
      "description": "Whether the contact is subscribed to email."
    },
    "mailingLists": {
      "type": "object",
      "description": "Map of mailing-list id -> subscribed boolean.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "boolean"
      }
    }
  }
}

loops_create_contact_property

Creates a custom contact property/field (additive schema change). Loops API: POST /v1/contacts/properties.

destructive

Argument	Type	Description
name*	string	Name of the custom property to create (required).
type*	string	Data type of the property (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "type"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the custom property to create (required)."
    },
    "type": {
      "enum": [
        "string",
        "number",
        "boolean",
        "date"
      ],
      "type": "string",
      "description": "Data type of the property (required)."
    }
  }
}

loops_delete_contact

Deletes a contact from Loops. Destructive. Supply email OR userId. Loops API: POST /v1/contacts/delete.

destructive

Argument	Type	Description
email	string	Email of the contact to delete.
userId	string	userId of the contact to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "email": {
      "type": "string",
      "description": "Email of the contact to delete."
    },
    "userId": {
      "type": "string",
      "description": "userId of the contact to delete."
    }
  }
}

loops_find_contact

Find a contact by email or userId (supply at least one). Loops API: GET /v1/contacts/find.

read-only

Argument	Type	Description
email	string	Contact email address to look up.
userId	string	Contact userId to look up (your app's user id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "email": {
      "type": "string",
      "description": "Contact email address to look up."
    },
    "userId": {
      "type": "string",
      "description": "Contact userId to look up (your app's user id)."
    }
  }
}

loops_list_contact_properties

List contact fields / custom properties defined in Loops. Loops API: GET /v1/contacts/properties.

read-only

Argument	Type	Description
list	string	Which properties to return: all (default) or custom only.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "list": {
      "enum": [
        "all",
        "custom"
      ],
      "type": "string",
      "description": "Which properties to return: all (default) or custom only."
    }
  }
}

loops_list_mailing_lists

List all mailing lists in the Loops account (id + name). Loops API: GET /v1/lists.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

loops_send_event

Sends an event to Loops for a contact — TRIGGERS any automations/loops subscribed to this event. Loops API: POST /v1/events/send.

destructive

Argument	Type	Description
email	string	Contact email (supply email or userId).
userId	string	Contact userId (supply email or userId).
eventName*	string	The event name to send (required).
mailingLists	object	Map of mailing-list id -> subscribed boolean.
eventProperties	object	Properties attached to this event.
contactProperties	object	Contact properties to update alongside the event.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "eventName"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Contact email (supply email or userId)."
    },
    "userId": {
      "type": "string",
      "description": "Contact userId (supply email or userId)."
    },
    "eventName": {
      "type": "string",
      "description": "The event name to send (required)."
    },
    "mailingLists": {
      "type": "object",
      "description": "Map of mailing-list id -> subscribed boolean.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "boolean"
      }
    },
    "eventProperties": {
      "type": "object",
      "description": "Properties attached to this event.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "contactProperties": {
      "type": "object",
      "description": "Contact properties to update alongside the event.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

loops_send_transactional

SENDS a real transactional email via a Loops template. This dispatches an actual email to the recipient. Loops API: POST /v1/transactional.

destructive

Argument	Type	Description
email*	string	Recipient email address (required).
attachments	array	Optional attachments: array of { filename, contentType, data } objects.
addToAudience	boolean	Whether to add the recipient to your audience.
dataVariables	object	Template data variables (string/number) to interpolate into the template.
transactionalId*	string	The Loops transactional template id (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "transactionalId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Recipient email address (required)."
    },
    "attachments": {
      "type": "array",
      "items": {},
      "description": "Optional attachments: array of { filename, contentType, data } objects."
    },
    "addToAudience": {
      "type": "boolean",
      "description": "Whether to add the recipient to your audience."
    },
    "dataVariables": {
      "type": "object",
      "description": "Template data variables (string/number) to interpolate into the template.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number"
        ]
      }
    },
    "transactionalId": {
      "type": "string",
      "description": "The Loops transactional template id (required)."
    }
  }
}

loops_test_api_key

Verify the configured Loops API key and return the team name — a good first call. Loops API: GET /v1/api-key.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

loops_update_contact

Updates (or creates) a contact by email/userId. Upserts — creates the contact if not found. Loops API: PUT /v1/contacts/update.

destructive

Argument	Type	Description
email*	string	Contact email address (required; identifies the contact).
source	string	Source label.
userId	string	Your app's user id (alternative identifier).
lastName	string	Last name.
firstName	string	First name.
userGroup	string	User group segment name.
properties	object	Arbitrary custom contact properties (string/number/boolean); merged into the request body.
subscribed	boolean	Whether the contact is subscribed to email.
mailingLists	object	Map of mailing-list id -> subscribed boolean.