# Robly MCP by usefulapi

> Robly MCP by usefulapi is an MCP server. Find Robly contacts and lists; subscribe, update and move contacts between lists. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/robly/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/robly
- **MCP Registry name:** io.usefulapi/robly
- **Listing updated:** 2026-11-13

## About

Find Robly contacts and lists; subscribe, update and move contacts between lists.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http robly https://robly.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://robly.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "robly": {
      "url": "https://robly.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "robly": {
      "type": "http",
      "url": "https://robly.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "robly": {
      "serverUrl": "https://robly.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "robly": {
      "type": "http",
      "url": "https://robly.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `robly_list_contacts`: List contacts (members) of the Robly account, newest first as Robly orders them: id, email, subscribed/deleted flags, subscription date, sign-up source, timestamps. Filter by status, by list, or by last-updated time; optionally include each contact's lists and data fields. Pages with limit (max 100) and offset: pass next_offset from the previous reply. Robly does not return a total. GET /api/v1/co
- `robly_find_contact`: Look up one contact by email address or member id: status, subscription date, sign-up source and, on request, the lists and data fields. Returns found: false when Robly has no such contact. GET /api/v1/contacts/search.
- `robly_check_list_membership`: Whether one contact (by email or member id) is on one list. GET /api/v1/contacts/exists_in_sub_list.
- `robly_list_sub_lists`: List the account's sub lists (the lists contacts belong to): id, name, position, timestamps. Public lists only unless include_all is true. Use the ids for list filters and for adding contacts. GET /api/v1/sub_lists/show.
- `robly_list_fields`: List the contact data fields (First Name, Last Name, custom fields): id, label, type, required flag and the user_tag that robly_subscribe_contact and robly_update_contact use as the field key. GET /api/v1/fields/show.
- `robly_get_signup_form`: The data fields and sub lists a new subscriber can be given through the sign-up API (public ones unless include_all is true). GET /api/v1/sign_up/show.
- `robly_subscribe_contact`: WRITE: add a new subscribed contact (or re-submit an existing one through the sign-up form). With double_opt_in Robly EMAILS the contact a confirmation link first; with welcome_email it EMAILS the welcome message right away; with include_autoresponder it triggers matching autoresponders, which email the contact. Only subscribe people who agreed to receive email. Field values go in `fields`, keyed 
- `robly_add_contact_to_list`: WRITE: put an existing contact on a list. With include_autoresponder Robly triggers autoresponders matching the newly listed contact, which EMAIL the contact. POST /api/v1/contacts/add_sub_list.
- `robly_remove_contact_from_list`: WRITE: take a contact off one list (the contact itself is kept). POST /api/v1/contacts/remove_sub_list.
- `robly_update_contact`: WRITE: change an existing contact's data fields and/or list memberships in one call. Name the contact by member_id (look it up with robly_find_contact). `fields` are keyed by user_tag (robly_list_fields); the email address cannot be changed here. add_to_list_ids puts the contact on those lists, remove_from_list_ids takes it off them. remove_from_all_other_lists also removes the contact from every 
- `robly_unsubscribe_contact`: WRITE: unsubscribe a contact so Robly stops emailing it. Robly's API cannot undo this: an unsubscribed contact can only come back through a sign-up form. Use it for a contact that asked to stop. POST /api/v1/contacts/unsubscribe.
- `robly_create_sub_list`: WRITE: create a new, empty sub list. Robly does not say whether a list with the same name already exists, so check robly_list_sub_lists first. POST /api/v1/sub_lists/add_sub_list.
- `robly_rename_sub_list`: WRITE: rename a sub list. POST /api/v1/sub_lists/rename_sub_list.

## FAQ

### How do I add Robly MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http robly https://robly.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/robly-mcp-by-usefulapi
