GR API Docs

GetResponse MCP Server ​

Connect AI assistants such as Claude, Cursor, VS Code, and ChatGPT to GetResponse through the Model Context Protocol.

The GetResponse MCP server lets compatible AI assistants work with your contacts, lists, newsletters, email templates, autoresponders, automation messages, AI campaigns, and message statistics through standardized tools.

How MCP works ​

The Model Context Protocol (MCP) is a standard for connecting AI assistants to external systems. After you add the GetResponse server to an MCP-compatible client, the client discovers the available tools and can use them to complete tasks you request.

The GetResponse MCP server uses Streamable HTTP and OAuth 2.0. When you connect, your client opens the GetResponse sign-in and authorization flow. You don't need to create or paste an API key.

Actions run with the permissions of the GetResponse account you authorize. Review proposed changes before approving actions that create or update account data.

Getting started ​

  1. Choose the MCP endpoint for your GetResponse account.
  2. Follow the agent setup instructions for your MCP client.
  3. Sign in to GetResponse and authorize the connection when prompted.

Available tools ​

The current tool list provides tool descriptions and input schemas, including required parameters and defaults.

Contacts and lists ​

  • get_campaigns — Returns the contact lists defined in your account.
  • get_custom_fields_list — Returns a paginated list of custom fields.
  • get_recently_added_contacts — Returns recently added contacts.
  • get_contacts_by_name — Searches for contacts by name.
  • get_contacts_by_campaign — Searches for contacts in a specified list.
  • get_contacts_who_received_any_message_in_last_days — Returns contacts who received a message during the specified number of days.
  • get_contacts_who_did_not_open_any_message_in_last_days — Returns contacts who didn't open a message during the specified number of days.
  • get_contacts_who_clicked_any_link_in_any_message_in_last_days — Returns contacts who clicked a link during the specified number of days.
  • get_contacts_who_opened_any_message_in_last_days — Returns contacts who opened a message during the specified number of days.
  • get_contacts_who_have_custom_field_assigned — Returns contacts that have a specified custom field assigned.

Newsletters ​

  • get_email_addresses_list — Returns the email addresses available to the current user.
  • get_newsletter_content — Returns the content of a specified newsletter.
  • get_drafts_list — Returns a paginated list of newsletter drafts.
  • copy_draft — Creates a copy of an existing newsletter draft.
  • get_draft_custom_texts — Extracts translatable texts from a JSON (drag-and-drop editor) draft as a map in the format { elementId: { path: text } }.
  • replace_draft_custom_texts — Replaces texts in a JSON draft and saves it. First use get_draft_custom_texts, translate the map values, and pass the map as texts with the draftId.
  • create_newsletter — Creates a newsletter.
  • update_newsletter — Updates an existing newsletter.
  • create_newsletter_with_content — Creates a newsletter with AI-generated content.

Newsletter statistics ​

  • get_general_performance — Returns a newsletter statistics summary for the specified conditions.
  • get_broadcasts_sent_between_dates — Returns newsletters sent between specified dates.
  • get_single_newsletter_performance_summary — Returns the performance summary for a specified newsletter.

Email templates ​

  • get_my_templates_list — Returns a paginated list of saved email templates, with an optional name filter.
  • get_my_template — Returns a specified email template, including its content.
  • create_my_template — Creates a saved email template using a name and HTML content, with optional plain-text content.
  • update_my_template — Updates a saved email template created in the HTML editor. Only provided fields are changed; empty values keep the current values.
  • duplicate_my_template — Duplicates a saved email template. If the copy's name is omitted or empty, it defaults to Copy of <original name>.
  • get_my_template_custom_texts — Extracts translatable texts from a JSON (drag-and-drop editor) template as a map in the format { elementId: { path: text } }.
  • replace_my_template_custom_texts — Replaces texts in a JSON template and saves it. First use get_my_template_custom_texts, translate the map values, and pass the map as texts with the templateId.

Autoresponders ​

  • get_autoresponders_list — Returns a paginated list of autoresponders, with an optional name filter.
  • get_autoresponder_content — Returns the content of a specified autoresponder.
  • create_autoresponder — Creates an autoresponder. The optional dayOfCycle defaults to 0 (the day of signing up), and deliveryDays defaults to all days of the week.
  • update_autoresponder — Updates only the provided autoresponder fields. Empty string fields, dayOfCycle: -1, and empty deliveryDays keep the current values. Set clickTracking to enabled or disabled to change tracking; the default is unchanged.
  • create_autoresponder_with_content — Creates an autoresponder with AI-generated content.

Autoresponder statistics ​

  • get_autoresponders_general_performance — Returns an autoresponder statistics summary for the required dateFrom and dateTo dates in YYYY-MM-DD format.
  • get_autoresponders_sent_between_dates — Returns autoresponders sent between dates, with optional dateFrom, dateTo, and name filters.
  • get_single_autoresponder_performance_summary — Returns the performance summary for a specified autoresponder.

Automation messages ​

  • get_automation_messages_list — Returns a paginated list of automation messages, with an optional name filter.
  • get_automation_message_content — Returns the content of a specified automation message.
  • create_automation_message — Creates an automation message.
  • update_automation_message — Updates only the provided automation message fields. Empty string fields keep the current values. Set clickTracking to enabled or disabled to change tracking; the default is unchanged.

Automation message statistics ​

  • get_automation_messages_general_performance — Returns an automation message statistics summary for the required dateFrom and dateTo dates in YYYY-MM-DD format.
  • get_automation_messages_sent_between_dates — Returns automation messages sent between dates, with optional dateFrom, dateTo, and name filters.
  • get_single_automation_message_performance_summary — Returns the performance summary for a specified automation message.

AI campaigns ​

  • create_marketing_campaign — Creates a marketing campaign with a landing page, newsletter, and welcome message.