Find Robly contacts and lists; subscribe, update and move contacts between lists.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Sub list id from robly_list_sub_lists.
The contact's email address. Give this OR member_id.
Robly contact (member) id. Give this OR email.
Trigger matching autoresponders (they email the contact).
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
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.
| Argument | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
| sub_list_id* | integer | Sub list id from robly_list_sub_lists. |
| include_autoresponder | boolean | Trigger matching autoresponders (they email the contact). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sub_list_id"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The contact's email address. Give this OR member_id."
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id. Give this OR email.",
"exclusiveMinimum": 0
},
"sub_list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sub list id from robly_list_sub_lists.",
"exclusiveMinimum": 0
},
"include_autoresponder": {
"type": "boolean",
"description": "Trigger matching autoresponders (they email the contact)."
}
}
}Whether one contact (by email or member id) is on one list. GET /api/v1/contacts/exists_in_sub_list.
| Argument | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
| sub_list_id* | integer | Sub list id from robly_list_sub_lists. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sub_list_id"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The contact's email address. Give this OR member_id."
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id. Give this OR email.",
"exclusiveMinimum": 0
},
"sub_list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sub list id from robly_list_sub_lists.",
"exclusiveMinimum": 0
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the new list. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Name of the new list."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
| include_fields | boolean | Include the contact's data fields. |
| include_sub_lists | boolean | Include the lists the contact is on. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The contact's email address. Give this OR member_id."
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id. Give this OR email.",
"exclusiveMinimum": 0
},
"include_fields": {
"type": "boolean",
"description": "Include the contact's data fields."
},
"include_sub_lists": {
"type": "boolean",
"description": "Include the lists the contact is on."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| include_all | boolean | Also include non-public fields and lists. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_all": {
"type": "boolean",
"description": "Also include non-public fields and lists."
}
}
}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/contacts/show.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Contacts per page, 1-100 (default 25). |
| offset | integer | Contacts to skip (default 0). |
| status | string | Only contacts with this status (default all). |
| list_id | integer | Only contacts on this list (sub list id from robly_list_sub_lists). |
| updated_since | string | Only contacts changed since this ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z. |
| include_fields | boolean | Include each contact's data fields (name, custom fields). |
| include_sub_lists | boolean | Include the lists each contact is on. |
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.
| Argument | Type | Description |
|---|---|---|
| include_all | boolean | Also include fields hidden from public sign-up forms. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_all": {
"type": "boolean",
"description": "Also include fields hidden from public sign-up forms."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| include_all | boolean | Also include non-public lists. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_all": {
"type": "boolean",
"description": "Also include non-public lists."
}
}
}WRITE: take a contact off one list (the contact itself is kept). POST /api/v1/contacts/remove_sub_list.
| Argument | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
| sub_list_id* | integer | Sub list id from robly_list_sub_lists. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sub_list_id"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The contact's email address. Give this OR member_id."
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id. Give this OR email.",
"exclusiveMinimum": 0
},
"sub_list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sub list id from robly_list_sub_lists.",
"exclusiveMinimum": 0
}
}
}WRITE: rename a sub list. POST /api/v1/sub_lists/rename_sub_list.
| Argument | Type | Description |
|---|---|---|
| name* | string | The new name. |
| sub_list_id* | integer | Sub list id from robly_list_sub_lists. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sub_list_id",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The new name."
},
"sub_list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Sub list id from robly_list_sub_lists.",
"exclusiveMinimum": 0
}
}
}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 by the user_tag from robly_list_fields (for example fname, lname). POST /api/v1/sign_up/generate.
| Argument | Type | Description |
|---|---|---|
| email* | string | The new contact's email address. |
| fields | object | Data field values keyed by user_tag, e.g. {"fname": "Ada", "lname": "Lovelace"}. |
| sub_list_ids | array | Lists to put the contact on (ids from robly_list_sub_lists). |
| double_opt_in | boolean | Send a confirmation email; the contact is subscribed only after clicking it, then gets the welcome email. |
| welcome_email | boolean | Skip confirmation and send the welcome email now. |
| return_contact | boolean | Return the created contact. |
| include_autoresponder | boolean |
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.
| Argument | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The contact's email address. Give this OR member_id."
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id. Give this OR email.",
"exclusiveMinimum": 0
}
}
}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 list NOT named in add_to_list_ids (requires add_to_list_ids). include_autoresponder triggers autoresponders that EMAIL the contact. POST /api/v1/contacts/update_full_contact.
| Argument | Type | Description |
|---|---|---|
| fields | object | Data field values keyed by user_tag, e.g. {"fname": "Ada"}. |
| member_id* | integer | Robly contact (member) id. |
| add_to_list_ids | array | Lists to put the contact on. |
| remove_from_list_ids | array | Lists to take the contact off. |
| include_autoresponder | boolean | Trigger matching autoresponders (they email the contact). |
| remove_from_all_other_lists | boolean | Also remove the contact from every list not in add_to_list_ids. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Contacts per page, 1-100 (default 25)."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Contacts to skip (default 0)."
},
"status": {
"enum": [
"all",
"subscribed",
"unsubscribed",
"deleted"
],
"type": "string",
"description": "Only contacts with this status (default all)."
},
"list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only contacts on this list (sub list id from robly_list_sub_lists).",
"exclusiveMinimum": 0
},
"updated_since": {
"type": "string",
"description": "Only contacts changed since this ISO 8601 date-time with a timezone, e.g. 2026-10-01T00:00:00Z."
},
"include_fields": {
"type": "boolean",
"description": "Include each contact's data fields (name, custom fields)."
},
"include_sub_lists": {
"type": "boolean",
"description": "Include the lists each contact is on."
}
}
}| Trigger matching autoresponders (they email the contact). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;:]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$",
"maxLength": 254,
"minLength": 3,
"description": "The new contact's email address."
},
"fields": {
"type": "object",
"description": "Data field values keyed by user_tag, e.g. {\"fname\": \"Ada\", \"lname\": \"Lovelace\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
},
"sub_list_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 50,
"description": "Lists to put the contact on (ids from robly_list_sub_lists)."
},
"double_opt_in": {
"type": "boolean",
"description": "Send a confirmation email; the contact is subscribed only after clicking it, then gets the welcome email."
},
"welcome_email": {
"type": "boolean",
"description": "Skip confirmation and send the welcome email now."
},
"return_contact": {
"type": "boolean",
"description": "Return the created contact."
},
"include_autoresponder": {
"type": "boolean",
"description": "Trigger matching autoresponders (they email the contact)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"member_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Data field values keyed by user_tag, e.g. {\"fname\": \"Ada\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string",
"maxLength": 1000
}
},
"member_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Robly contact (member) id.",
"exclusiveMinimum": 0
},
"add_to_list_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 50,
"description": "Lists to put the contact on."
},
"remove_from_list_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 50,
"description": "Lists to take the contact off."
},
"include_autoresponder": {
"type": "boolean",
"description": "Trigger matching autoresponders (they email the contact)."
},
"remove_from_all_other_lists": {
"type": "boolean",
"description": "Also remove the contact from every list not in add_to_list_ids."
}
}
}