# Moosend — how to use (mcp.ai)

Connect your Moosend account and use 31 tools for email newsletters straight from your AI agent. Connect with your own API key. Moosend is a cloud-based, AI-powered email marketing solution that allows you to target your audience at scale.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/moosend/add/segment/criteria` — Tool to add a new criterion (rule) to a segment. Use after obtaining the mailing list ID and segment ID to define filtering criteria.
  - body: { field: string, value: string, format?: string, date_to?: string, comparer?: string, date_from?: string, segment_id: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/add/subscriber` — Tool to add or update a subscriber in a mailing list. Use after obtaining the mailing list ID to manage subscribers.
  - body: { Name?: string, Tags?: string[], Email: string, format?: string, Preferences?: string[], CustomFields?: string[], mailingListID: string, HasExternalDoubleOptIn?: boolean }
- `POST https://api.mcp.ai/api/moosend/clone/campaign` — Tool to clone an existing campaign, creating an exact copy with the same content and settings. Use when you want to reuse a campaign template or create variations of an existing campaign. The cloned c
  - body: { format?: string, campaign_id: string }
- `POST https://api.mcp.ai/api/moosend/create/custom/field` — Tool to create a custom field in a mailing list. Use when you need to define a new custom field for subscriber data.
  - body: { name: string, format?: string, options?: string, is_hidden?: boolean, is_required?: boolean, mailing_list_id: string, custom_field_type?: string }
- `POST https://api.mcp.ai/api/moosend/create/mailing/list` — Tool to create a new empty mailing list in Moosend. Use after obtaining API key.
  - body: { Name: string, ConfirmationPage?: string, RedirectAfterUnsubscribePage?: string }
- `POST https://api.mcp.ai/api/moosend/create/segment` — Tool to create a new segment for a mailing list. Use to organize subscribers based on criteria or create empty segments for future use.
  - body: { Name: string, format?: string, Criteria?: object[], FetchType?: string, MatchType?: string, FetchValue?: integer, mailingListID: string }
- `POST https://api.mcp.ai/api/moosend/delete/campaign` — Permanently deletes a campaign from your Moosend account by its ID. This action removes draft or sent campaigns irreversibly. Use this when you need to clean up campaigns that are no longer needed. Th
  - body: { format?: string, campaign_id: string }
- `POST https://api.mcp.ai/api/moosend/delete/custom/field` — Tool to remove a custom field definition from a mailing list. Use when you have confirmed the custom field ID to delete.
  - body: { format?: string, custom_field_id: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/delete/mailing/list` — Tool to delete a mailing list. Use when you need to permanently remove a mailing list from your Moosend account after confirming its ID. Deletion is irreversible.
  - body: { format?: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/get/all/campaigns` — Tool to retrieve a list of all campaigns in your account. Use after acquiring valid API credentials to explore campaign data.
  - body: { page?: integer, format?: string }
- `POST https://api.mcp.ai/api/moosend/get/all/subscribers` — Retrieves all subscribers from a specified mailing list, filtered by their subscription status (Subscribed, Unsubscribed, Bounced, or Removed). Returns paginated results with subscriber details includ
  - body: { Page?: integer, format?: string, status?: string, PageSize?: integer, mailingListID: string }
- `POST https://api.mcp.ai/api/moosend/get/campaign/details` — Retrieves comprehensive details about a specific campaign by its ID. Returns complete campaign information including configuration, status, content, and settings. Use this when you need to inspect or 
  - body: { campaign_id: string }
- `POST https://api.mcp.ai/api/moosend/get/campaign/stats/by/location` — Retrieves a detailed report of campaign opens (unique and total) by country. Use this when you need to analyze the geographic distribution of email campaign engagement.
  - body: { campaign_id: string }
- `POST https://api.mcp.ai/api/moosend/get/mailing/list/details` — Gets details for a given mailing list including name, member counts, status, and custom field definitions. Optionally include subscriber statistics. Use this when you need to inspect mailing list prop
  - body: { format?: string, mailing_list_id: string, with_statistics?: string }
- `POST https://api.mcp.ai/api/moosend/get/subscriber/by/email` — Retrieves detailed subscriber information by email address from a specific mailing list. Returns comprehensive subscriber data including ID, name, subscription status, custom fields, tags, preferences
  - body: { Email: string, format?: string, mailingListID: string }
- `POST https://api.mcp.ai/api/moosend/list/all/mailing/lists` — Tool to get a list of your active mailing lists in your account. Use after acquiring valid API credentials to explore mailing list data. Optionally include statistics and sort results by various field
  - body: { Page?: integer, Format?: string, ShortBy?: string, PageSize?: integer, SortMethod?: string, WithStatistics?: string }
- `POST https://api.mcp.ai/api/moosend/list/all/senders` — Tool to retrieve a list of all active senders in your account. Use when you need to view available sender email addresses for campaigns.
  - body: { format?: string }
- `POST https://api.mcp.ai/api/moosend/list/campaigns/with/paging` — Tool to retrieve a paginated list of all campaigns in your account with detailed information. Use when you need to fetch campaigns with specific page size and sorting options. Paging information is re
  - body: { page: integer, sort_by?: string, page_size: integer, sort_method?: string }
- `POST https://api.mcp.ai/api/moosend/list/segments` — Tool to get a list of all segments with their criteria for a specified mailing list. Use when you need to retrieve segment definitions for targeting specific subscriber groups.
  - body: { format?: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/remove/multiple/subscribers` — Tool to permanently remove multiple subscribers from a mailing list. Use when you need to delete multiple subscribers permanently without adding them to the suppression list. Invalid email addresses a
  - body: { Emails: string, format?: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/schedule/campaign` — Tool to schedule a campaign. Use when you want to set a specific date and time for campaign delivery after confirming its ID.
  - body: { format?: string, TimeZone?: string, campaign_id: string, ScheduledDateTime: string }
- `POST https://api.mcp.ai/api/moosend/send/campaign` — Tool to send an existing draft campaign immediately. Use when you want to dispatch a campaign to all recipients after final review.
  - body: { Format?: string, CampaignID: string }
- `POST https://api.mcp.ai/api/moosend/unschedule/campaign` — Tool to unschedule a campaign. Removes a previously defined scheduled date and time from a campaign, so that it will be delivered immediately if already queued or when sent.
  - body: { format?: string, campaign_id: string }
- `POST https://api.mcp.ai/api/moosend/unsubscribe/from/account` — Tool to unsubscribe a subscriber from the account. Use when you need to remove a subscriber from all mailing lists. Note: Rate limit is 20 requests per 10 seconds per API key.
  - body: { Email: string, format?: string }
- `POST https://api.mcp.ai/api/moosend/unsubscribe/from/mailing/list` — Tool to unsubscribe a subscriber from a specified mailing list. Use when you need to remove a subscriber's active subscription. Rate limit: 20 requests per 10 seconds per API key.
  - body: { Email: string, format?: string, mailingListID: string }
- `POST https://api.mcp.ai/api/moosend/update/campaign` — Tool to update a draft campaign. Use when you want to modify properties of an existing draft campaign before sending.
  - body: { IsAB?: boolean, Name: string, format?: string, Subject?: string, SubjectB?: string, CampaignID: string, HoursToTest?: integer, SenderEmail?: string, WebLocation?: string, HTMLContentB?: string, MailingLists?: object[], ReplyToEmail?: string, SenderEmailB?: string, WebLocationB?: string, ABCampaignType?: string, ListPercentage?: integer, ConfirmationToEmail?: string, ABWinnerSelectionType?: string, TrackInGoogleAnalytics?: boolean }
- `POST https://api.mcp.ai/api/moosend/update/custom/field` — Tool to update properties of an existing custom field in a mailing list. Use after confirming mailing list and custom field IDs.
  - body: { name: string, format?: string, options?: string, is_hidden?: boolean, is_required?: boolean, custom_field_id: string, mailing_list_id: string, custom_field_type?: string }
- `POST https://api.mcp.ai/api/moosend/update/mailing/list` — Tool to update the properties of an existing mailing list. Use when you need to change list metadata after confirming the list ID.
  - body: { name?: string, format?: string, description?: string, sender_name?: string, sender_email?: string, reply_to_email?: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/update/segment` — Tool to update properties and criteria of an existing segment. Use when you need to modify segment name, match type, or filtering criteria.
  - body: { Name?: string, format?: string, Criteria?: object[], FetchType?: string, MatchType?: string, FetchValue?: integer, segment_id: string, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/update/segment/criteria` — Tool to update an existing criterion in a segment. Use when you need to modify filtering rules for a mailing list segment.
  - body: { field: string, value: string, format?: string, date_to?: string, comparer?: string, date_from?: string, segment_id: string, criteria_id: integer, mailing_list_id: string }
- `POST https://api.mcp.ai/api/moosend/update/subscriber` — Tool to update a subscriber in the specified mailing list. Use when you need to modify subscriber information like email, name, or custom fields.
  - body: { Name?: string, Email: string, format?: string, CustomFields?: string[], subscriberID: string, mailingListID: string, HasExternalDoubleOptIn?: boolean }

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

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