GetResponse MCP by usefulapi MCP server

getresponse_create_contact

Add a contact to a campaign (mailing list). GetResponse processes this asynchronously and returns HTTP 202 (queued) with no body — the contact appears in the list within a few minutes. REST: POST /contacts.

destructive

Argument	Type	Description
name	string	Contact name (defaults to 'Friend' if omitted).
note	string	A free-text note to attach to the contact.
tags	array	Array of tag ids to apply to the contact.
email*	string	Contact email address (required).
ipAddress	string	Contact IP address, used by GetResponse for geolocation.
campaignId*	string	The campaign (list) id to add the contact to (required).
dayOfCycle	integer	Autoresponder cycle day to place the contact on (→ dayOfCycle).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "email",
    "campaignId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Contact name (defaults to 'Friend' if omitted)."
    },
    "note": {
      "type": "string",
      "description": "A free-text note to attach to the contact."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of tag ids to apply to the contact."
    },
    "email": {
      "type": "string",
      "description": "Contact email address (required)."
    },
    "ipAddress": {
      "type": "string",
      "description": "Contact IP address, used by GetResponse for geolocation."
    },
    "campaignId": {
      "type": "string",
      "description": "The campaign (list) id to add the contact to (required)."
    },
    "dayOfCycle": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Autoresponder cycle day to place the contact on (→ dayOfCycle)."
    }
  }
}

getresponse_delete_contact

Delete (remove) a contact from the account. This unsubscribes them and deletes their data. REST: DELETE /contacts/{contactId}.

destructive

Argument	Type	Description
contactId*	string	The contact id to delete.
ipAddress	string	Optional IP address to record for the deletion (→ query[ipAddress]).
messageId	string	Optional id of the message this deletion is attributed to (→ query[messageId]).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contactId"
  ],
  "properties": {
    "contactId": {
      "type": "string",
      "description": "The contact id to delete."
    },
    "ipAddress": {
      "type": "string",
      "description": "Optional IP address to record for the deletion (→ query[ipAddress])."
    },
    "messageId": {
      "type": "string",
      "description": "Optional id of the message this deletion is attributed to (→ query[messageId])."
    }
  }
}

getresponse_get_account

Get the authenticated GetResponse account profile (id, email, name, company, plan, timezone, etc.). REST: GET /accounts.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

getresponse_get_campaign

Get a single campaign (mailing list) by id, including subscription confirmation settings. REST: GET /campaigns/{campaignId}.

read-only

Argument	Type	Description
campaignId*	string	The campaign (list) id — the alphanumeric token, not the numeric id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "The campaign (list) id — the alphanumeric token, not the numeric id."
    }
  }
}

getresponse_get_contact

Get a single contact by id, including campaign membership, tags, custom field values and engagement scoring. REST: GET /contacts/{contactId}.

read-only

Argument	Type	Description
fields	string	Comma-separated list of fields to return, e.g. "name,email" (GetResponse `fields`).
contactId*	string	The contact id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contactId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return, e.g. \"name,email\" (GetResponse `fields`)."
    },
    "contactId": {
      "type": "string",
      "description": "The contact id."
    }
  }
}

getresponse_get_newsletter

Get a single newsletter (email broadcast) by id, including its status and send settings. REST: GET /newsletters/{newsletterId}.

read-only

Argument	Type	Description
newsletterId*	string	The newsletter id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "newsletterId"
  ],
  "properties": {
    "newsletterId": {
      "type": "string",
      "description": "The newsletter id."
    }
  }
}

getresponse_list_autoresponders

List autoresponders (drip/cycle emails sent automatically on a schedule after subscription). Paginated. REST: GET /autoresponders.

read-only

Argument	Type	Description
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    }
  }
}

getresponse_list_campaigns

List the account's campaigns — GetResponse's name for mailing lists a contact can subscribe to. Paginated. Optional name filter and sort. REST: GET /campaigns.

read-only

Argument	Type	Description
name	string	Filter by campaign (list) name substring (→ query[name]).
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).
sortName	string	Sort by campaign name ASC/DESC (→ sort[name]).
sortCreatedOn	string	Sort by created date ASC/DESC (→ sort[createdOn]).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "description": "Filter by campaign (list) name substring (→ query[name])."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    },
    "sortName": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort by campaign name ASC/DESC (→ sort[name])."
    },
    "sortCreatedOn": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort by created date ASC/DESC (→ sort[createdOn])."
    }
  }
}

getresponse_list_contacts

List/search contacts across the account. Paginated, with optional email/name/campaign filters, sort, and a fields selector. REST: GET /contacts.

read-only

Argument	Type	Description
name	string	Filter by name substring (→ query[name]).
page	integer	1-based page number (pagination).
email	string	Filter by email substring (→ query[email]).
fields	string	Comma-separated list of fields to return, e.g. "name,email" (GetResponse `fields`).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).
sortEmail	string	Sort by email ASC/DESC (→ sort[email]).
campaignId	string	Restrict to contacts in this campaign (list) id (→ query[campaignId]).
sortCreatedOn	string	Sort by created date ASC/DESC (→ sort[createdOn]).

Input schema (JSON)

getresponse_list_custom_fields

List the account's custom field definitions (custom contact attributes) — id, name, type and values. REST: GET /custom-fields.

read-only

Argument	Type	Description
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    }
  }
}

getresponse_list_from_fields

List the account's verified 'from' fields (sender name/email addresses usable when sending). REST: GET /from-fields.

read-only

Argument	Type	Description
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    }
  }
}

getresponse_list_newsletters

List newsletters (one-off email broadcasts). Paginated, with optional subject filter and sort. REST: GET /newsletters.

read-only

Argument	Type	Description
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).
subject	string	Filter by subject substring (→ query[subject]).
sortCreatedOn	string	Sort by created date ASC/DESC (→ sort[createdOn]).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    },
    "subject": {
      "type": "string",
      "description": "Filter by subject substring (→ query[subject])."
    },
    "sortCreatedOn": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort by created date ASC/DESC (→ sort[createdOn])."
    }
  }
}

getresponse_list_tags

List the account's tags (labels applied to contacts for segmentation). REST: GET /tags.

read-only

Argument	Type	Description
page	integer	1-based page number (pagination).
perPage	integer	Records per page (GetResponse `perPage`; default 100, max 1000).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "1-based page number (pagination).",
      "exclusiveMinimum": 0
    },
    "perPage": {
      "type": "integer",
      "maximum": 1000,
      "description": "Records per page (GetResponse `perPage`; default 100, max 1000).",
      "exclusiveMinimum": 0
    }
  }
}

getresponse_update_contact

Update an existing contact's mutable fields (name, tags, custom field values). Only the fields you supply are changed. REST: POST /contacts/{contactId}.

destructive

Argument	Type	Description
name	string	New contact name.
tags	array	Array of tag ids to set on the contact.
contactId*	string	The contact id to update.
customFieldValues	array	Custom field values to set (each { customFieldId, value:[...] }).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contactId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New contact name."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of tag ids to set on the contact."
    },
    "contactId": {
      "type": "string",
      "description": "The contact id to update."
    },
    "customFieldValues": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "customFieldId",
          "value"
        ],
        "properties": {
          "value": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The value(s) for the custom field (array, even for single values)."
          },
          "customFieldId": {
            "type": "string",
            "description": "The custom field id."
          }
        }
      },
      "description": "Custom field values to set (each { customFieldId, value:[...] })."
    }
  }
}

GetResponse MCP by usefulapi

Try it

getresponse_create_contact

GetResponse MCP by usefulapi

Try it

getresponse_create_contact

Tools (14)