Loops MCP by usefulapi is an MCP server published by io.usefulapi, hosted at loops.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including loops_test_api_key, loops_find_contact, loops_list_contact_properties, loops_list_mailing_lists, loops_create_contact.
Manage Loops contacts, mailing lists, and transactional/event emails.
4,094 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Verify the configured Loops API key and return the team name — a good first call. Loops API: GET /v1/api-key.
No parameters.
{
"name": "loops_test_api_key",
"title": "Test API key",
"description": "Verify the configured Loops API key and return the team name — a good first call. Loops API: GET /v1/api-key.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Test API key",
"readOnlyHint": true
}
}Find a contact by email or userId (supply at least one). Loops API: GET /v1/contacts/find.
| Parameter | Type | Description |
|---|---|---|
| string | Contact email address to look up. | |
| userId | string | Contact userId to look up (your app's user id). |
{
"name": "loops_find_contact",
"title": "Find a contact",
"description": "Find a contact by email or userId (supply at least one). Loops API: GET /v1/contacts/find.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Find a contact",
"readOnlyHint": true
}
}List contact fields / custom properties defined in Loops. Loops API: GET /v1/contacts/properties.
| Parameter | Type | Description |
|---|---|---|
| list | string | Which properties to return: all (default) or custom only. |
{
"name": "loops_list_contact_properties",
"title": "List contact properties",
"description": "List contact fields / custom properties defined in Loops. Loops API: GET /v1/contacts/properties.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List contact properties",
"readOnlyHint": true
}
}List all mailing lists in the Loops account (id + name). Loops API: GET /v1/lists.
No parameters.
{
"name": "loops_list_mailing_lists",
"title": "List mailing lists",
"description": "List all mailing lists in the Loops account (id + name). Loops API: GET /v1/lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List mailing lists",
"readOnlyHint": true
}
}Creates a contact in Loops (additive). Loops API: POST /v1/contacts/create.
| Parameter | 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. |
{
"name": "loops_create_contact",
"title": "Create a contact",
"description": "Creates a contact in Loops (additive). Loops API: POST /v1/contacts/create.",
"inputSchema": {
"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"
}
}
}
},
"annotations": {
"title": "Create a contact",
"destructiveHint": true
}
}Updates (or creates) a contact by email/userId. Upserts — creates the contact if not found. Loops API: PUT /v1/contacts/update.
| Parameter | 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. |
Deletes a contact from Loops. Destructive. Supply email OR userId. Loops API: POST /v1/contacts/delete.
| Parameter | Type | Description |
|---|---|---|
| string | Email of the contact to delete. | |
| userId | string | userId of the contact to delete. |
{
"name": "loops_delete_contact",
"title": "Delete a contact",
"description": "Deletes a contact from Loops. Destructive. Supply email OR userId. Loops API: POST /v1/contacts/delete.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Delete a contact",
"destructiveHint": true
}
}Creates a custom contact property/field (additive schema change). Loops API: POST /v1/contacts/properties.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Name of the custom property to create (required). |
| type * | string | Data type of the property (required). |
{
"name": "loops_create_contact_property",
"title": "Create a contact property",
"description": "Creates a custom contact property/field (additive schema change). Loops API: POST /v1/contacts/properties.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Create a contact property",
"destructiveHint": true
}
}Sends an event to Loops for a contact — TRIGGERS any automations/loops subscribed to this event. Loops API: POST /v1/events/send.
| Parameter | Type | Description |
|---|---|---|
| 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. |
{
"name": "loops_send_event",
"title": "Send an event",
"description": "Sends an event to Loops for a contact — TRIGGERS any automations/loops subscribed to this event. Loops API: POST /v1/events/send.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "Send an event",
"destructiveHint": true
}
}SENDS a real transactional email via a Loops template. This dispatches an actual email to the recipient. Loops API: POST /v1/transactional.
| Parameter | 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). |
{
"name": "loops_send_transactional",
"title": "Send a transactional email",
"description": "SENDS a real transactional email via a Loops template. This dispatches an actual email to the recipient. Loops API: POST /v1/transactional.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Send a transactional email",
"destructiveHint": true
}
}Tools for Loops, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Look up the contact jane@acme.example and show what we know."; "Which mailing lists have I set up in my account?"; "What custom contact properties have I defined?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Loops data. Free plan: 50 tool calls per month. Run loops_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run loops_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run loops_upgrade without a plan: it returns both plans, each with a payment link for the user to open. loops_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "loops_update_contact",
"title": "Update a contact",
"description": "Updates (or creates) a contact by email/userId. Upserts — creates the contact if not found. Loops API: PUT /v1/contacts/update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Contact email address (required; identifies the contact)."
},
"source": {
"type": "string",
"description": "Source label."
},
"userId": {
"type": "string",
"description": "Your app's user id (alternative identifier)."
},
"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"
}
}
}
},
"annotations": {
"title": "Update a contact",
"destructiveHint": true
}
}