io.usefulapi/retainful

up checked 2026-11-11T10:37:36.210Z

Unclaimed · Unverified

Publisher-provided title

Retainful MCP by usefulapi

Publisher-provided description

List contacts and lists; create contacts, add them to lists and record events in Retainful.

Summary by lookupd

Lists and creates contacts, adds them to lists, and records timeline events in Retainful, including writes that can trigger automations.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http retainful https://retainful.usefulapi.io/mcp

Codex, remote (streamable-http)

codex mcp add retainful --url https://retainful.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "retainful": {
      "url": "https://retainful.usefulapi.io/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Publisher-provided text

retainful_list_contacts List contacts (profiles) in the Retainful organization, one page at a time, with consent status and source. Retainful API: GET /customer.
retainful_get_contact Get one contact (profile) by its Retainful id (contactUUID), with its attributes. Retainful API: GET /customer/{id}.
retainful_list_lists List the lists and segments in the organization with their ids. Use the id as list_id in retainful_add_contact_to_list. Retainful API: GET /contact-groups.
retainful_get_list Get one list or segment by its id. Retainful API: GET /contact-groups/{id}.
retainful_upsert_contact WRITE: create a contact, or update it when the email or phone already exists. Does not add anyone to a list. email_opt_in is required: it sets marketing consent
retainful_add_contact_to_list WRITE: create or update a contact by email and add them to a list in one call. A list can start an automation. email_opt_in is required: an existing contact is
retainful_track_event WRITE: record one event on a contact's timeline. Automations triggered by the event can email the contact. Reuse the same unique_identifier only for a retry of

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/retainful.svg)](https://lookupd.com/servers/io.usefulapi/retainful)