Robly MCP by usefulapi is an MCP server published by io.usefulapi, hosted at robly.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including robly_list_contacts, robly_find_contact, robly_check_list_membership, robly_list_sub_lists, robly_list_fields.
Find Robly contacts and lists; subscribe, update and move contacts between lists.
4,093 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | 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 |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| 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. |
{
"name": "robly_list_contacts",
"title": "List contacts",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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. |
{
"name": "robly_find_contact",
"title": "Find contact",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Find contact",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Whether one contact (by email or member id) is on one list. GET /api/v1/contacts/exists_in_sub_list.
| Parameter | 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. |
{
"name": "robly_check_list_membership",
"title": "Check list membership",
"description": "Whether one contact (by email or member id) is on one list. GET /api/v1/contacts/exists_in_sub_list.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Check list membership",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| include_all | boolean | Also include non-public lists. |
{
"name": "robly_list_sub_lists",
"title": "List sub lists",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_all": {
"type": "boolean",
"description": "Also include non-public lists."
}
}
},
"annotations": {
"title": "List sub lists",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| include_all | boolean | Also include fields hidden from public sign-up forms. |
{
"name": "robly_list_fields",
"title": "List data fields",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List data fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| include_all | boolean | Also include non-public fields and lists. |
{
"name": "robly_get_signup_form",
"title": "Get sign-up form",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_all": {
"type": "boolean",
"description": "Also include non-public fields and lists."
}
}
},
"annotations": {
"title": "Get sign-up form",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 | Trigger matching autoresponders (they email the contact). |
{
"name": "robly_subscribe_contact",
"title": "Subscribe contact",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Subscribe contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | 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). |
{
"name": "robly_add_contact_to_list",
"title": "Add contact to list",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Add contact to list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: take a contact off one list (the contact itself is kept). POST /api/v1/contacts/remove_sub_list.
| Parameter | 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. |
{
"name": "robly_remove_contact_from_list",
"title": "Remove contact from list",
"description": "WRITE: take a contact off one list (the contact itself is kept). POST /api/v1/contacts/remove_sub_list.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Remove contact from list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "robly_update_contact",
"title": "Update contact",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Update contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | The contact's email address. Give this OR member_id. | |
| member_id | integer | Robly contact (member) id. Give this OR email. |
{
"name": "robly_unsubscribe_contact",
"title": "Unsubscribe contact",
"description": "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.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Unsubscribe contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Name of the new list. |
{
"name": "robly_create_sub_list",
"title": "Create sub list",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create sub list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: rename a sub list. POST /api/v1/sub_lists/rename_sub_list.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The new name. |
| sub_list_id * | integer | Sub list id from robly_list_sub_lists. |
{
"name": "robly_rename_sub_list",
"title": "Rename sub list",
"description": "WRITE: rename a sub list. POST /api/v1/sub_lists/rename_sub_list.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Rename sub list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Robly, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which contacts joined my Robly account this week, and which lists are they on?"; "Is jane@example.com subscribed, and which lists is she on?"; "Add john@example.com to the Newsletter list with the first name John.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Robly data. Free plan: 50 tool calls per month. Run robly_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run robly_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run robly_upgrade without a plan: it returns both plans, each with a payment link for the user to open. robly_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.