# Doppler Marketing Automation — how to use (mcp.ai)

Connect your Doppler Marketing Automation account and use 38 tools for marketing automation straight from your AI agent. Connect with your own API key. Doppler is a marketing automation platform that enables users to create, send, and analyze email campaigns, manage subscriber lists, and integrate with various tools to enhance marketing efforts.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_doppler_marketing_automation?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `doppler_marketing_automation_add_subscriber`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/doppler_marketing_automation`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/doppler_marketing_automation/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/doppler_marketing_automation/add/subscriber` — Tool to add a new subscriber to a specific list for a specified account.
  - body: { tags?: string[], email: string, fields?: object[], listId: integer, origin?: string, status?: string, language?: string, accountName: string, sentOptionalMailing?: boolean }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/check/accounts/subscribers` — Tool to check if a subscriber exists in a Doppler account by their email. Use when you need to verify subscriber existence without retrieving full details.
  - body: { email: string, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/create/accounts/subscribers` — Tool to create or associate a subscriber to a Doppler account with optional list memberships. Use when you need to add a new subscriber at the account level, optionally associating them with specific 
  - body: { email: string, score?: integer, _links?: object[], fields?: object[], status?: string, userId?: integer, account_name: string, listsHistory?: object[], belongsToLists?: string[], canBeReactivated?: boolean, unsubscribedDate?: string, isBeingReactivated?: boolean, unsubscriptionType?: string, unsubscriptionComment?: string, manualUnsubscriptionReason?: string, x_doppler_subscriber_origin?: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/create/accounts/unsubscribed` — Tool to mark a subscriber as unsubscribed (removed) in an account. Use when a subscriber needs to be unsubscribed. If the email does not exist, it will be added to ensure it remains unsubscribed and d
  - body: { email: string, fields?: object[], accountName: string, unsubscriptionType?: string, unsubscriptionComment?: string, manualUnsubscriptionReason?: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/create/list` — Tool to create a new subscriber list for a specified account. Use when you need to segment contacts into a new list.
  - body: { name: string, accountName: string, description?: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/delete/list` — Tool to delete a specific subscriber list by its ID. Use when permanently removing a list after confirming its no longer needed.
  - body: { listId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/account` — Tool to retrieve account details and available action links for a specific Doppler account. Use when you need to discover available operations for an account.
  - body: { accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/api/index` — Tool to retrieve the API index with available actions and links. Use when you need to discover available API endpoints and their relations.
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/campaign` — Tool to retrieve details of a specific campaign by campaign ID. Use when you need to fetch metadata and configuration of an existing campaign.
  - body: { campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/campaign/content` — Tool to retrieve the HTML content of a campaign email. Use when you need to fetch the email content for a specific campaign.
  - body: { campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/campaign/social/media` — Tool to retrieve social media configuration for a specific campaign. Use when you need to check which social media platforms are enabled for sharing a campaign.
  - body: { campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/campaigns` — Tool to retrieve all campaigns associated with the specified account. Use after confirming the accountName to fetch campaigns.
  - body: { type?: string, limit?: integer, dateTo?: string, offset?: integer, status?: string, dateFrom?: string, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/list` — Tool to retrieve details of a specific subscriber list by its ID. Use when you need to fetch metadata of an existing list.
  - body: { listId: string, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/lists` — Tool to retrieve all lists associated with a specified Doppler account. Use when you need an overview of all mailing lists. Example: "Retrieve lists for account test@gmail.com"
  - body: { page?: integer, pageSize?: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/removed/subscribers` — Tool to retrieve subscribers removed from all lists. Use when you need to audit unsubscribes within a date range.
  - body: { page?: integer, to_date?: string, per_page?: integer, from_date?: string, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/subscriber` — Tool to retrieve details of a specific subscriber by their email. Use when you need to fetch subscriber information for a given account.
  - body: { email: string, account_id: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/subscriber/perm/history` — Tool to retrieve the update history of a permission field for a specific subscriber. Use when you need to track changes to subscriber consent or permission fields.
  - body: { page?: integer, email: string, per_page?: integer, field_name: string, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/subscribers` — Tool to retrieve all subscribers of a specific list. Use when you need to fetch subscribers by list ID.
  - body: { page?: integer, fields?: string, status?: string, list_id: integer, to_date?: string, per_page?: integer, from_date?: string, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/get/task` — Tool to retrieve details of a specific task by its ID. Use when you need to check the status or details of an asynchronous task.
  - body: { task_id: string, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/import/subscribers` — Tool to import multiple subscribers into a specific list in bulk. Use when you need to add or update a batch of subscriber records after preparing the data.
  - body: { listId: integer, reimport?: boolean, accountName: string, subscribers: object[], returnAlreadyExisting?: boolean }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/import/subscribers/csv` — Tool to import subscribers from CSV data into a specific list. Creates an asynchronous import task. Use when you need to bulk import subscribers from CSV format with a maximum file size of 50MB.
  - body: { listId: integer, csvData: string, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/import/subscribers/to/account` — Tool to import multiple subscribers into an account. Use when you need to bulk import subscribers at the account level (not to a specific list).
  - body: { items: object[], fields: string[], callback?: string, accountName: string, enableEmailNotification?: boolean, X-Doppler-Subscriber-Origin?: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/import/unsubscribed` — Tool to import a batch of unsubscribed (removed) subscribers for a Doppler account. Use when you need to mark multiple subscribers as removed. If an email does not correspond to an existing Doppler su
  - body: { items: object[], accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/accounts/fields` — Tool to retrieve all custom fields for a Doppler account. Use when you need to view the available custom fields that can be used for subscribers.
  - body: { accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/accounts/subscribers` — Tool to retrieve paginated subscribers of a Doppler account. Use when you need to fetch all subscribers for an account with pagination support.
  - body: { page?: integer, keyword?: string, perPage?: integer, resumeFrom?: integer, accountName: string, updatedAfter?: string, withFieldType?: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/accounts/tasks` — Tool to retrieve a paginated collection of tasks linked to a specific account. Returns both active and inactive tasks that can be filtered by status.
  - body: { page?: integer, per_page?: integer, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/accounts/tasks/errors` — Tool to retrieve errors from a specific import task. Use when you need to check what errors occurred during a subscriber import operation.
  - body: { page?: integer, taskId: string, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/accounts/unsubscribed` — Tool to retrieve a paginated collection of subscribers who have unsubscribed from your lists. Use when you need to audit unsubscribes within a specific date range.
  - body: { to: string, from: string, page?: integer, per_page?: integer, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/automations` — Tool to retrieve all automations for a specified Doppler account. Use when you need to fetch automation workflows and campaigns. Returns paginated results.
  - body: { page?: integer, per_page?: integer, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/campaign/recipients` — Tool to retrieve recipients (lists and segments) of a specific campaign. Use when you need to see which lists or segments are targeted by a campaign.
  - body: { campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/list/subscriber/deliveries` — Tool to retrieve delivery details of all campaigns sent to a specific subscriber. Use when you need to fetch campaign delivery history for a subscriber.
  - body: { page?: integer, email: string, per_page?: integer, account_name: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/remove/subscriber` — Tool to remove a specific subscriber from a list. Use when you need to delete a subscriber after confirming they should no longer be subscribed.
  - body: { listId: integer, accountName: string, subscriberEmail: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/accounts/integrations` — Tool to create or update a third-party app integration for a Doppler account. Use when you need to configure OAuth tokens or refresh integration credentials for services like MercadoShops, VTEX, or Pr
  - body: { idAccount?: integer, accessToken?: string, accountName: string, refreshToken?: string, accountNameBody?: string, integrationName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/campaign/recipients` — Tool to update the recipients (lists and/or segments) of a campaign. Use when you need to modify which subscriber lists or segments are targeted by a specific campaign.
  - body: { lists?: object[], segments?: object[], campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/campaign/social/media` — Tool to update social media preferences for a campaign. Use when you need to configure which social networks are enabled for sharing, posting, or likes for a specific campaign.
  - body: { likes?: string[], share?: string[], rssPost?: boolean, campaignId: integer, accountName: string, twitterPost?: boolean, linkedInPost?: boolean, rssDescription?: string, facebookWallPost?: boolean, facebookPagesPost?: object[] }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/campaign/text/alt` — Tool to update the alternative text content of a campaign. Use when you need to edit the plain text version for email clients that don't support HTML.
  - body: { text: string, campaignId: integer, accountName: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/dbl/optin/tmpl/content` — Tool to update the HTML content of a double opt-in validation template. Use when you need to modify the email template sent to subscribers for subscription confirmation.
  - body: { templateId: integer, accountName: string, htmlContent: string }
- `POST https://api.mcp.ai/api/doppler_marketing_automation/update/list` — Tool to update details of an existing subscriber list. Use when you need to modify list metadata after creation.
  - body: { name: string, listId: integer, isPublic?: boolean, optInType: string, accountName: string, description?: string }

## Example prompts
- "What can I do in Doppler Marketing Automation?"
- "Show me a summary of my Doppler Marketing Automation account"

## More
- Page: https://mcp.ai/doppler_marketing_automation
- Agent spec (llms.txt): https://mcp.ai/doppler_marketing_automation/llms.txt
- Postman collection: https://mcp.ai/doppler_marketing_automation/postman.json