MCP server
Retainful MCP by usefulapi
List contacts and lists; create contacts, add them to lists and record events in…
- Runs
- Remotely
- Version
- 1.6.0
- Listing updated
- 4 days ago
About Retainful MCP by usefulapi
Retainful MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
List contacts and lists; create contacts, add them to lists and record events in Retainful.
Install
Run in a terminal
claude mcp add --transport http retainful https://retainful.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://retainful.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"retainful": {
"url": "https://retainful.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"retainful": {
"type": "http",
"url": "https://retainful.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"retainful": {
"serverUrl": "https://retainful.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"retainful": {
"type": "http",
"url": "https://retainful.usefulapi.io/mcp"
}
}
}Tools this server provides (7)
Read directly from the server.
- 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, so send SUBSCRIBED only with real consent. Needs email or phone. Retainful API: POST /customer/create.
- 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 set to SUBSCRIBED when it is omitted here. Retainful API: POST /contact-groups/{listId}/contacts.
- 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 the same real occurrence (a repeat does not trigger automations again); use a new one for each new occurrence. Event data must be flat: strings, numbers, or booleans. Retainful API: POST /events.
Retainful MCP by usefulapi FAQ
How do I add Retainful MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http retainful https://retainful.usefulapi.io/mcp