Loops MCP by usefulapi
Manage Loops contacts, mailing lists, and transactional/event emails.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"loops": {
"url": "https://loops.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://loops.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (10)
🟢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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢loops_find_contact(email, userId)
Find a contact by email or userId (supply at least one). Loops API: GET /v1/contacts/find.
입력 스키마
{
"type": "object",
"properties": {
"email": {
"description": "Contact email address to look up.",
"type": "string"
},
"userId": {
"description": "Contact userId to look up (your app's user id).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢loops_list_contact_properties(list)
List contact fields / custom properties defined in Loops. Loops API: GET /v1/contacts/properties.
입력 스키마
{
"type": "object",
"properties": {
"list": {
"description": "Which properties to return: all (default) or custom only.",
"type": "string",
"enum": [
"all",
"custom"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢loops_list_mailing_lists
List all mailing lists in the Loops account (id + name). Loops API: GET /v1/lists.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_create_contact(email, firstName, lastName, source, subscribed, ...)
Creates a contact in Loops (additive). Loops API: POST /v1/contacts/create.
입력 스키마
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Contact email address (required)."
},
"firstName": {
"description": "First name.",
"type": "string"
},
"lastName": {
"description": "Last name.",
"type": "string"
},
"source": {
"description": "Source label for where the contact came from.",
"type": "string"
},
"subscribed": {
"description": "Whether the contact is subscribed to email.",
"type": "boolean"
},
"userGroup": {
"description": "User group segment name.",
"type": "string"
},
"userId": {
"description": "Your app's user id for this contact.",
"type": "string"
},
"mailingLists": {
"description": "Map of mailing-list id -> subscribed boolean.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
}
},
"properties": {
"description": "Arbitrary custom contact properties (string/number/boolean); merged into the request body.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"required": [
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_update_contact(email, firstName, lastName, source, subscribed, ...)
Updates (or creates) a contact by email/userId. Upserts — creates the contact if not found. Loops API: PUT /v1/contacts/update.
입력 스키마
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Contact email address (required; identifies the contact)."
},
"firstName": {
"description": "First name.",
"type": "string"
},
"lastName": {
"description": "Last name.",
"type": "string"
},
"source": {
"description": "Source label.",
"type": "string"
},
"subscribed": {
"description": "Whether the contact is subscribed to email.",
"type": "boolean"
},
"userGroup": {
"description": "User group segment name.",
"type": "string"
},
"userId": {
"description": "Your app's user id (alternative identifier).",
"type": "string"
},
"mailingLists": {
"description": "Map of mailing-list id -> subscribed boolean.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
}
},
"properties": {
"description": "Arbitrary custom contact properties (string/number/boolean); merged into the request body.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"required": [
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_delete_contact(email, userId)
Deletes a contact from Loops. Destructive. Supply email OR userId. Loops API: POST /v1/contacts/delete.
입력 스키마
{
"type": "object",
"properties": {
"email": {
"description": "Email of the contact to delete.",
"type": "string"
},
"userId": {
"description": "userId of the contact to delete.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_create_contact_property(name, type)
Creates a custom contact property/field (additive schema change). Loops API: POST /v1/contacts/properties.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the custom property to create (required)."
},
"type": {
"type": "string",
"enum": [
"string",
"number",
"boolean",
"date"
],
"description": "Data type of the property (required)."
}
},
"required": [
"name",
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_send_event(eventName, email, userId, eventProperties, contactProperties, ...)
Sends an event to Loops for a contact — TRIGGERS any automations/loops subscribed to this event. Loops API: POST /v1/events/send.
입력 스키마
{
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "The event name to send (required)."
},
"email": {
"description": "Contact email (supply email or userId).",
"type": "string"
},
"userId": {
"description": "Contact userId (supply email or userId).",
"type": "string"
},
"eventProperties": {
"description": "Properties attached to this event.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"contactProperties": {
"description": "Contact properties to update alongside the event.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"mailingLists": {
"description": "Map of mailing-list id -> subscribed boolean.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
}
}
},
"required": [
"eventName"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴loops_send_transactional(transactionalId, email, dataVariables, addToAudience, attachments)
SENDS a real transactional email via a Loops template. This dispatches an actual email to the recipient. Loops API: POST /v1/transactional.
입력 스키마
{
"type": "object",
"properties": {
"transactionalId": {
"type": "string",
"description": "The Loops transactional template id (required)."
},
"email": {
"type": "string",
"description": "Recipient email address (required)."
},
"dataVariables": {
"description": "Template data variables (string/number) to interpolate into the template.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number"
]
}
},
"addToAudience": {
"description": "Whether to add the recipient to your audience.",
"type": "boolean"
},
"attachments": {
"description": "Optional attachments: array of { filename, contentType, data } objects.",
"type": "array",
"items": {}
}
},
"required": [
"transactionalId",
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거