# Enginemailer — how to use (mcp.ai)

Connect your Enginemailer account and use 38 tools for email newsletters straight from your AI agent. Connect with your own API key. Enginemailer is an email marketing platform that enables businesses to manage contacts, design campaigns, and send personalized emails.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_enginemailer?ms=1787293560000`
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. `enginemailer_activate_subscriber`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/enginemailer`
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/enginemailer/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/enginemailer/activate/subscriber` — Tool to activate an inactive subscriber in EngineMailer. Use when you need to reactivate a subscriber that was previously deactivated either through the API or manually.
  - body: { email: string }
- `POST https://api.mcp.ai/api/enginemailer/add/update/subscriber` — Tool to add or update a subscriber with custom fields via N8N integration. Use when you need to create a new subscriber or update an existing one in the EngineMailer system.
  - body: { email: string, lastName?: string, firstName?: string, customFields?: object }
- `POST https://api.mcp.ai/api/enginemailer/batch/update/status` — Tool to check the status of a batch subscriber update operation. Use when you need to verify if a batch update job has completed or is still processing.
  - body: { ID: integer|string }
- `POST https://api.mcp.ai/api/enginemailer/batch/update/subscribers` — Tool to add or update multiple subscribers with custom fields in a single batch operation. Use when you need to create or update multiple subscribers efficiently. Subscribers that fail validation are 
  - body: { subscribers: object[] }
- `POST https://api.mcp.ai/api/enginemailer/check/export/status/v2` — Tool to check status of a previously requested CSV report export. Use after initiating an export to poll for completion. Large exports may take significant time; poll repeatedly until status indicates
  - body: { ID: integer }
- `POST https://api.mcp.ai/api/enginemailer/connect` — Tool to test API connection and verify authentication. Use when you need to validate API credentials or check connectivity.
- `POST https://api.mcp.ai/api/enginemailer/create/campaign` — Tool to create a new email campaign. Use when you need to configure and schedule a campaign before sending. Set trackOpens and trackClicks at creation; these flags cannot retroactively affect already-
  - body: { replyTo?: string, fromName: string, sendDate: string, toListID: integer, fromEmail: string, trackOpens?: boolean, attachments?: string[], trackClicks?: boolean, campaignName: string, campaignText?: string, campaignContent: string, campaignSubject: string }
- `POST https://api.mcp.ai/api/enginemailer/delete/campaign` — Tool to delete an undelivered email campaign. Use when you need to remove a campaign that has not been sent yet.
  - body: { CampaignID: string }
- `POST https://api.mcp.ai/api/enginemailer/delete/recipient/list` — Tool to delete an existing recipient list from a targeted campaign. Use when you need to remove a specific recipient list from a campaign.
  - body: { campaignid: string, recipientlistid: string }
- `POST https://api.mcp.ai/api/enginemailer/delete/subscriber` — Tool to remove a subscriber from the system by email address. Use when you need to permanently delete a subscriber's record.
  - body: { email: string }
- `POST https://api.mcp.ai/api/enginemailer/export/csv/report/v2` — Tool to export a transactional email report as CSV. Initiates an async export within a specific date range (max past 60 days); check readiness via ENGINEMAILER_CHECK_EXPORT_STATUS_V2 before using the 
  - body: { Period: string, DomainFilter?: string, EmailToFilter?: string }
- `POST https://api.mcp.ai/api/enginemailer/find/subscriber` — Tool to find a subscriber by email address via N8N integration. Use when you need to search for and retrieve subscriber information from the EngineMailer system.
  - body: { email: string }
- `POST https://api.mcp.ai/api/enginemailer/get/getcustomfield` — Tool to retrieve the list of custom fields configured for subscribers. Use when you need to discover available custom fields for subscriber management.
- `POST https://api.mcp.ai/api/enginemailer/get/listcampaign` — Tool to get a list of undelivered campaigns. Use when you need to fetch campaigns awaiting delivery.
- `POST https://api.mcp.ai/api/enginemailer/get/new/subscribers` — Tool to retrieve new subscribers with optional filtering by source, form, page, or popup. Use when you need to fetch recently added subscribers for synchronization or reporting workflows.
  - body: { limit?: integer, source?: string, filter_form?: integer, filter_page?: integer, filter_popup?: integer, lastpollingdate?: string }
- `POST https://api.mcp.ai/api/enginemailer/get/subcategory` — Tool to retrieve subcategories for a given category. Use when you need to list or choose subcategories after selecting a category.
  - body: { CategoryID: integer }
- `POST https://api.mcp.ai/api/enginemailer/get/subscriber` — Tool to retrieve subscriber information by email address. Use when you need to fetch details about a specific subscriber including their custom fields.
  - body: { email: string }
- `POST https://api.mcp.ai/api/enginemailer/get/subscriber/autoresponder/completed` — Tool to retrieve subscribers who completed autoresponders with optional filtering by autoresponder ID. Use when you need to fetch completion events for autoresponders, optionally filtered by specific 
  - body: { limit?: integer, lastpollingdate?: string, filter_autoresponder?: integer }
- `POST https://api.mcp.ai/api/enginemailer/get/subscriber/autoresponder/triggered` — Tool to retrieve subscribers who triggered autoresponders with optional filtering by autoresponder ID. Use when you need to fetch trigger events for autoresponders, optionally filtered by specific aut
  - body: { limit?: integer, lastpollingdate?: string, filter_autoresponder?: integer }
- `POST https://api.mcp.ai/api/enginemailer/get/subscribers/deleted` — Tool to retrieve deleted subscribers since last polling date. Use when you need to track or sync subscribers who have been removed from the system.
  - body: { limit?: integer, lastpollingdate?: string }
- `POST https://api.mcp.ai/api/enginemailer/get/subscribers/modified` — Tool to retrieve modified subscribers since last polling date with optional limit. Use when you need to fetch recently modified subscribers for synchronization or polling workflows.
  - body: { limit?: integer, lastpollingdate?: string }
- `POST https://api.mcp.ai/api/enginemailer/get/subscribers/tagged` — Tool to retrieve subscribers who were tagged with optional filtering by subcategory. Use when you need to fetch tagged subscribers for synchronization or reporting workflows.
  - body: { limit?: integer, lastpollingdate?: string, filter_subcategory?: integer }
- `POST https://api.mcp.ai/api/enginemailer/get/subscribers/untagged` — Tool to retrieve subscribers who were untagged from subcategories. Use when you need to track or sync subscribers who have had tags removed, with optional filtering by subcategory and polling date.
  - body: { limit?: integer, lastpollingdate?: string, filter_subcategory?: integer }
- `POST https://api.mcp.ai/api/enginemailer/get/unsubscribe` — Tool to retrieve unsubscribe events with optional filtering by campaign or autoresponder. Use when you need to fetch unsubscribe data for reporting, synchronization, or compliance workflows.
  - body: { limit?: integer, filter?: string, filter_campaign?: integer, lastpollingdate?: string, filter_autoresponder?: integer }
- `POST https://api.mcp.ai/api/enginemailer/insert/subscriber` — Tool to add a new subscriber with optional custom fields. Use when registering a user to a specific mailing list after verifying their email.
  - body: { name?: string, email: string, listid?: integer|string, customfields?: object[] }
- `POST https://api.mcp.ai/api/enginemailer/list/autoresponders` — Tool to retrieve a list of all autoresponders. Use when you need to fetch available autoresponders configured in the system.
- `POST https://api.mcp.ai/api/enginemailer/list/campaigns` — Tool to retrieve a list of all campaigns. Use when you need to fetch all campaigns from the system.
- `POST https://api.mcp.ai/api/enginemailer/list/forms` — Tool to retrieve a list of available forms in Enginemailer. Use when you need to discover forms for n8n integration or workflow configuration.
- `POST https://api.mcp.ai/api/enginemailer/list/pages` — Tool to retrieve a list of all pages. Use when you need to fetch available pages.
- `POST https://api.mcp.ai/api/enginemailer/list/popups` — Tool to retrieve a list of popups from Enginemailer. Use when you need to fetch available popups for n8n workflows.
- `POST https://api.mcp.ai/api/enginemailer/list/templates` — Tool to retrieve a list of all email templates. Use when you need to fetch available email templates for campaigns.
- `POST https://api.mcp.ai/api/enginemailer/pause/campaign` — Tool to pause a scheduled email campaign. Use when you need to halt a campaign before sending to apply updates or adjust schedule.
  - body: { CampaignID: string }
- `POST https://api.mcp.ai/api/enginemailer/post/update/subscriber` — Tool to update data for an existing subscriber in EngineMailer. Use when you need to modify subscriber information such as custom fields or subcategory assignments.
  - body: { email: string, subcategory?: string|string[], customfields?: object[] }
- `POST https://api.mcp.ai/api/enginemailer/post/updatecategory` — Tool to create or update a category for subscriber segmentation. Use when organizing subscribers by common interests for targeted email marketing.
  - body: { categoryDesc: string, categoryName: string }
- `POST https://api.mcp.ai/api/enginemailer/send/campaign` — Tool to send an email campaign immediately. Use when the campaign exists, has at least one recipient, and is not scheduled or already delivered. E.g., 'Send campaign 123 now'.
  - body: { CampaignID: integer }
- `POST https://api.mcp.ai/api/enginemailer/tag/to/subcategory` — Tool to tag a subscriber to a specific subcategory via N8N API endpoint. Use when you need to categorize or organize subscribers by assigning them to a subcategory.
  - body: { email: string, subcategoryId: integer|string }
- `POST https://api.mcp.ai/api/enginemailer/unsubscribe` — Tool to unsubscribe a subscriber via N8N API endpoint. Use when you need to remove a subscriber from the mailing list using the N8N integration endpoint.
  - body: { email: string }
- `POST https://api.mcp.ai/api/enginemailer/unsubscribe/subscriber` — Tool to unsubscribe a subscriber from the email list. Use when a user requests to be removed from the mailing list or to comply with unsubscribe requests.
  - body: { email: string }

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

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