Moosend MCP by usefulapi is an MCP server published by io.usefulapi, hosted at moosend.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 20 tools, including moosend_list_mailing_lists, moosend_get_mailing_list, moosend_list_subscribers, moosend_get_subscriber_by_email, moosend_get_subscriber.
Inspect Moosend lists, subscribers, segments and campaign stats, and add or unsubscribe subscribers.
4,180 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the active email (mailing) lists in the account with member counts (active, bounced, removed, unsubscribed), custom field definitions and preferences, plus paging info. A cheap way to confirm the API key works and to find list IDs. Moosend: GET /lists/{Page}/{PageSize}.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Default 1. |
| sort_by | string | Property to sort by. Default CreatedOn. |
| page_size | integer | Results per page, 1-1000. |
| sort_method | string | Sort direction. Default ASC. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "moosend_list_mailing_lists",
"title": "List mailing lists",
"description": "List the active email (mailing) lists in the account with member counts (active, bounced, removed, unsubscribed), custom field definitions and preferences, plus paging info. A cheap way to confirm the API key works and to find list IDs. Moosend: GET /lists/{Page}/{PageSize}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Default 1."
},
"sort_by": {
"enum": [
"Name",
"Subject",
"Status",
"DeliveredOn",
"CreatedOn"
],
"type": "string",
"description": "Property to sort by. Default CreatedOn."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Results per page, 1-1000."
},
"sort_method": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction. Default ASC."
}
}
},
"annotations": {
"title": "List mailing lists",
"readOnlyHint": true
}
}Get one mailing list: name, member counts, status, custom field definitions (id, name, type, required), preferences and the latest import operation. Moosend: GET /lists/{MailingListID}/details.json.
| Parameter | Type | Description |
|---|---|---|
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
| with_statistics | boolean | Include subscriber statistics. Default true. |
{
"name": "moosend_get_mailing_list",
"title": "Get mailing list details",
"description": "Get one mailing list: name, member counts, status, custom field definitions (id, name, type, required), preferences and the latest import operation. Moosend: GET /lists/{MailingListID}/details.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id"
],
"properties": {
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
},
"with_statistics": {
"type": "boolean",
"description": "Include subscriber statistics. Default true."
}
}
},
"annotations": {
"title": "Get mailing list details",
"readOnlyHint": true
}
}List the subscribers of one mailing list filtered by status (Subscribed, Unsubscribed, Bounced or Removed), with name, email, custom fields, tags, preferences and dates. Paged. Moosend: GET /lists/{MailingListID}/subscribers/{Status}.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Default 1. |
| status | string | Subscriber status to return. Default Subscribed. |
| page_size | integer | Results per page, 1-1000. |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_list_subscribers",
"title": "List subscribers in a list",
"description": "List the subscribers of one mailing list filtered by status (Subscribed, Unsubscribed, Bounced or Removed), with name, email, custom fields, tags, preferences and dates. Paged. Moosend: GET /lists/{MailingListID}/subscribers/{Status}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Default 1."
},
"status": {
"enum": [
"Subscribed",
"Unsubscribed",
"Bounced",
"Removed"
],
"type": "string",
"description": "Subscriber status to return. Default Subscribed."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Results per page, 1-1000."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "List subscribers in a list",
"readOnlyHint": true
}
}Look up a subscriber in one mailing list by email address: ID, name, status (SubscribeType 1 subscribed, 2 unsubscribed, 3 bounced, 4 removed), custom fields, tags and preferences. Moosend: GET /subscribers/{MailingListID}/view.json?Email=.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Subscriber email address. |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_get_subscriber_by_email",
"title": "Find subscriber by email",
"description": "Look up a subscriber in one mailing list by email address: ID, name, status (SubscribeType 1 subscribed, 2 unsubscribed, 3 bounced, 4 removed), custom fields, tags and preferences. Moosend: GET /subscribers/{MailingListID}/view.json?Email=.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Subscriber email address."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "Find subscriber by email",
"readOnlyHint": true
}
}Get one subscriber in a mailing list by subscriber ID. Moosend: GET /subscribers/{MailingListID}/find/{SubscriberID}.json.
| Parameter | Type | Description |
|---|---|---|
| subscriber_id * | string | Subscriber ID (a GUID). |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_get_subscriber",
"title": "Get subscriber by ID",
"description": "Get one subscriber in a mailing list by subscriber ID. Moosend: GET /subscribers/{MailingListID}/find/{SubscriberID}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"subscriber_id"
],
"properties": {
"subscriber_id": {
"type": "string",
"minLength": 1,
"description": "Subscriber ID (a GUID)."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "Get subscriber by ID",
"readOnlyHint": true
}
}List the segments of one mailing list, including their criteria, match type (0 all / 1 any) and a readable description. Moosend: GET /lists/{MailingListID}/segments.json.
| Parameter | Type | Description |
|---|---|---|
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_list_segments",
"title": "List segments of a list",
"description": "List the segments of one mailing list, including their criteria, match type (0 all / 1 any) and a readable description. Moosend: GET /lists/{MailingListID}/segments.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id"
],
"properties": {
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "List segments of a list",
"readOnlyHint": true
}
}Get one segment's details and criteria (not its members). Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/details.json.
| Parameter | Type | Description |
|---|---|---|
| segment_id * | any | Segment ID (an integer, from moosend_list_segments). |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_get_segment",
"title": "Get segment details",
"description": "Get one segment's details and criteria (not its members). Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/details.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"segment_id"
],
"properties": {
"segment_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Segment ID (an integer, from moosend_list_segments)."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "Get segment details",
"readOnlyHint": true
}
}List the subscribers that currently match one segment's criteria. Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/members.json.
| Parameter | Type | Description |
|---|---|---|
| segment_id * | any | Segment ID (an integer, from moosend_list_segments). |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_list_segment_subscribers",
"title": "List segment subscribers",
"description": "List the subscribers that currently match one segment's criteria. Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/members.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"segment_id"
],
"properties": {
"segment_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Segment ID (an integer, from moosend_list_segments)."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "List segment subscribers",
"readOnlyHint": true
}
}List campaigns with status (0 draft, 1 queued, 3 sent, 5 awaiting delivery, 6 sending, ...), delivery/schedule dates, target lists and headline stats (sent, opens, clicks, bounces, unsubscribes, complaints). Paged, up to 1000 per page. Moosend: GET /campaigns/{Page}/{PageSize}.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Default 1. |
| sort_by | string | Property to sort by. Default CreatedOn. |
| page_size | integer | Results per page, 1-1000. |
| sort_method | string | Sort direction. Default ASC. |
{
"name": "moosend_list_campaigns",
"title": "List campaigns",
"description": "List campaigns with status (0 draft, 1 queued, 3 sent, 5 awaiting delivery, 6 sending, ...), delivery/schedule dates, target lists and headline stats (sent, opens, clicks, bounces, unsubscribes, complaints). Paged, up to 1000 per page. Moosend: GET /campaigns/{Page}/{PageSize}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Default 1."
},
"sort_by": {
"enum": [
"Name",
"Subject",
"Status",
"DeliveredOn",
"CreatedOn"
],
"type": "string",
"description": "Property to sort by. Default CreatedOn."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Results per page, 1-1000."
},
"sort_method": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction. Default ASC."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true
}
}Get one campaign's details: subject, sender and reply-to, HTML and plain content, target lists/segments, schedule, status and A/B data. No statistics (use moosend_get_campaign_summary). Moosend: GET /campaigns/{CampaignID}/view.json.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign ID (a GUID, from moosend_list_campaigns). |
{
"name": "moosend_get_campaign",
"title": "Get campaign details",
"description": "Get one campaign's details: subject, sender and reply-to, HTML and plain content, target lists/segments, schedule, status and A/B data. No statistics (use moosend_get_campaign_summary). Moosend: GET /campaigns/{CampaignID}/view.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "Campaign ID (a GUID, from moosend_list_campaigns)."
}
}
},
"annotations": {
"title": "Get campaign details",
"readOnlyHint": true
}
}Get a sent campaign's results to date: sent, total/unique opens, total/unique link clicks, bounces, complaints, forwards and unsubscribes. Moosend: GET /campaigns/{CampaignID}/view_summary.json.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign ID (a GUID, from moosend_list_campaigns). |
{
"name": "moosend_get_campaign_summary",
"title": "Get campaign summary",
"description": "Get a sent campaign's results to date: sent, total/unique opens, total/unique link clicks, bounces, complaints, forwards and unsubscribes. Moosend: GET /campaigns/{CampaignID}/view_summary.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "Campaign ID (a GUID, from moosend_list_campaigns)."
}
}
},
"annotations": {
"title": "Get campaign summary",
"readOnlyHint": true
}
}Per-recipient activity for a campaign by type: Sent, Opened, LinkClicked, Unsubscribed, Bounced, Complained, or Activity (all). Paged (default 50, max 1000) and filterable by date. NOTE: Moosend rate-limits this endpoint to 2 calls per 60 seconds per API key. Moosend: GET /campaigns/{CampaignID}/stats/{Type}.json.
| Parameter | Type | Description |
|---|---|---|
| to | string | End date, DD-MM-YYYY. Default: today. |
| from | string | Start date, DD-MM-YYYY. Default: the send date. |
| page | integer | Page number, starting at 1. Default 1. |
| type | string | Activity type. Default Sent. |
| page_size | integer | Results per page, 1-1000. |
| campaign_id * | string | Campaign ID (a GUID, from moosend_list_campaigns). |
{
"name": "moosend_get_campaign_activity",
"title": "Get campaign recipient activity",
"description": "Per-recipient activity for a campaign by type: Sent, Opened, LinkClicked, Unsubscribed, Bounced, Complained, or Activity (all). Paged (default 50, max 1000) and filterable by date. NOTE: Moosend rate-limits this endpoint to 2 calls per 60 seconds per API key. Moosend: GET /campaigns/{CampaignID}/stats/{Type}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{2}-\\d{2}-\\d{4}$",
"description": "End date, DD-MM-YYYY. Default: today."
},
"from": {
"type": "string",
"pattern": "^\\d{2}-\\d{2}-\\d{4}$",
"description": "Start date, DD-MM-YYYY. Default: the send date."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Default 1."
},
"type": {
"enum": [
"Sent",
"Opened",
"LinkClicked",
"Unsubscribed",
"Bounced",
"Complained",
"Activity"
],
"type": "string",
"description": "Activity type. Default Sent."
},
"page_size": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Results per page, 1-1000."
},
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "Campaign ID (a GUID, from moosend_list_campaigns)."
}
}
},
"annotations": {
"title": "Get campaign recipient activity",
"readOnlyHint": true
}
}List every link in a campaign with its total and unique click counts. Moosend: GET /campaigns/{CampaignID}/stats/links.json.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign ID (a GUID, from moosend_list_campaigns). |
{
"name": "moosend_get_campaign_link_activity",
"title": "Get campaign link clicks",
"description": "List every link in a campaign with its total and unique click counts. Moosend: GET /campaigns/{CampaignID}/stats/links.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "Campaign ID (a GUID, from moosend_list_campaigns)."
}
}
},
"annotations": {
"title": "Get campaign link clicks",
"readOnlyHint": true
}
}A campaign's total and unique opens broken down by country code. Moosend: GET /campaigns/{CampaignID}/stats/countries.json.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | Campaign ID (a GUID, from moosend_list_campaigns). |
{
"name": "moosend_get_campaign_activity_by_location",
"title": "Get campaign opens by country",
"description": "A campaign's total and unique opens broken down by country code. Moosend: GET /campaigns/{CampaignID}/stats/countries.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"description": "Campaign ID (a GUID, from moosend_list_campaigns)."
}
}
},
"annotations": {
"title": "Get campaign opens by country",
"readOnlyHint": true
}
}List the account's campaign senders (name, email, enabled, SPF/DKIM verification). A draft campaign's sender and reply-to must be one of these. Moosend: GET /senders/find_all.json.
No parameters.
{
"name": "moosend_list_senders",
"title": "List campaign senders",
"description": "List the account's campaign senders (name, email, enabled, SPF/DKIM verification). A draft campaign's sender and reply-to must be one of these. Moosend: GET /senders/find_all.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List campaign senders",
"readOnlyHint": true
}
}WRITE: create a new, empty mailing list. Returns the new list's ID. Moosend: POST /lists/create.json.
| Parameter | Type | Description |
|---|---|---|
| name * | string | List name. |
| preferences | object | Optional preference field for the list. Omit for none. |
| confirmation_page | string | URL shown at the end of the subscription process. |
| redirect_after_unsubscribe_page | string | URL subscribers are redirected to after unsubscribing. |
{
"name": "moosend_create_mailing_list",
"title": "Create a mailing list",
"description": "WRITE: create a new, empty mailing list. Returns the new list's ID. Moosend: POST /lists/create.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "List name."
},
"preferences": {
"type": "object",
"required": [
"select_type",
"options"
],
"properties": {
"options": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Up to 10 preference options."
},
"is_required": {
"type": "boolean",
"description": "Whether a choice is required. Default false."
},
"select_type": {
"enum": [
"SingleSelect",
"MultiSelect"
],
"type": "string",
"description": "Single- or multi-select."
}
},
"description": "Optional preference field for the list. Omit for none."
},
"confirmation_page": {
"type": "string",
"description": "URL shown at the end of the subscription process."
},
"redirect_after_unsubscribe_page": {
"type": "string",
"description": "URL subscribers are redirected to after unsubscribing."
}
}
},
"annotations": {
"title": "Create a mailing list",
"destructiveHint": true
}
}WRITE: add one subscriber to a mailing list. If the email already exists in the list, that subscriber is UPDATED instead (and custom fields you omit are cleared). A previously unsubscribed address is re-subscribed. Rate limit 10 calls / 10 s. Moosend: POST /subscribers/{MailingListID}/subscribe.json.
| Parameter | Type | Description |
|---|---|---|
| name | string | Subscriber name. |
| tags | array | Subscriber tags. |
| email * | string | Subscriber email address. |
| preferences | array | Preference option values chosen by the subscriber (must match the list's preference options). |
| custom_fields | object | Custom field values by field name, e.g. {"City":"Athens","Age":25}. Sent to Moosend as "Name=Value" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep. |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
| has_external_double_opt_in | boolean | True if the subscriber already gave consent by other means. |
{
"name": "moosend_add_subscriber",
"title": "Add or update a subscriber",
"description": "WRITE: add one subscriber to a mailing list. If the email already exists in the list, that subscriber is UPDATED instead (and custom fields you omit are cleared). A previously unsubscribed address is re-subscribed. Rate limit 10 calls / 10 s. Moosend: POST /subscribers/{MailingListID}/subscribe.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Subscriber name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Subscriber tags."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Subscriber email address."
},
"preferences": {
"type": "array",
"items": {
"type": "string"
},
"description": "Preference option values chosen by the subscriber (must match the list's preference options)."
},
"custom_fields": {
"type": "object",
"description": "Custom field values by field name, e.g. {\"City\":\"Athens\",\"Age\":25}. Sent to Moosend as \"Name=Value\" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
},
"has_external_double_opt_in": {
"type": "boolean",
"description": "True if the subscriber already gave consent by other means."
}
}
},
"annotations": {
"title": "Add or update a subscriber",
"destructiveHint": true
}
}WRITE: update one subscriber (by ID) in a mailing list — email, name, custom fields, tags, preferences. Include every custom field you want to keep. Moosend: POST /subscribers/{MailingListID}/update/{SubscriberID}.json.
| Parameter | Type | Description |
|---|---|---|
| name | string | Subscriber name. |
| tags | array | Subscriber tags. |
| email * | string | The subscriber's email address (required by Moosend). |
| preferences | array | Preference option values chosen by the subscriber (must match the list's preference options). |
| custom_fields | object | Custom field values by field name, e.g. {"City":"Athens","Age":25}. Sent to Moosend as "Name=Value" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep. |
| subscriber_id * | string | Subscriber ID (a GUID). |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
| has_external_double_opt_in | boolean | True if the subscriber already gave consent by other means. |
{
"name": "moosend_update_subscriber",
"title": "Update a subscriber",
"description": "WRITE: update one subscriber (by ID) in a mailing list — email, name, custom fields, tags, preferences. Include every custom field you want to keep. Moosend: POST /subscribers/{MailingListID}/update/{SubscriberID}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"subscriber_id",
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Subscriber name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Subscriber tags."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "The subscriber's email address (required by Moosend)."
},
"preferences": {
"type": "array",
"items": {
"type": "string"
},
"description": "Preference option values chosen by the subscriber (must match the list's preference options)."
},
"custom_fields": {
"type": "object",
"description": "Custom field values by field name, e.g. {\"City\":\"Athens\",\"Age\":25}. Sent to Moosend as \"Name=Value\" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"subscriber_id": {
"type": "string",
"minLength": 1,
"description": "Subscriber ID (a GUID)."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
},
"has_external_double_opt_in": {
"type": "boolean",
"description": "True if the subscriber already gave consent by other means."
}
}
},
"annotations": {
"title": "Update a subscriber",
"destructiveHint": true
}
}WRITE: unsubscribe one email address from one mailing list (not account-wide). Undo by adding the subscriber again with moosend_add_subscriber. Moosend: POST /subscribers/{MailingListID}/unsubscribe.json.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Email address to unsubscribe. |
| mailing_list_id * | string | Mailing list ID (a GUID, from moosend_list_mailing_lists). |
{
"name": "moosend_unsubscribe_subscriber",
"title": "Unsubscribe from a list",
"description": "WRITE: unsubscribe one email address from one mailing list (not account-wide). Undo by adding the subscriber again with moosend_add_subscriber. Moosend: POST /subscribers/{MailingListID}/unsubscribe.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mailing_list_id",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email address to unsubscribe."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
}
}
},
"annotations": {
"title": "Unsubscribe from a list",
"destructiveHint": true
}
}WRITE: create a regular (non-A/B) DRAFT campaign. It is NOT sent — sending stays a human action in Moosend. Give the content as html_content or a web_location URL. sender_email and reply_to_email must be senders in the account (see moosend_list_senders). Returns the new campaign's ID. Moosend: POST /campaigns/create.json.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Campaign name. |
| subject * | string | Subject line. |
| html_content | string | Complete HTML body of the campaign. |
| sender_email * | string | Sender email — must be one of the account's senders. |
| web_location | string | URL Moosend fetches the HTML from (CSS is inlined automatically). |
| mailing_lists * | array | Target lists, each optionally narrowed to one segment. |
| reply_to_email | string | Reply-to email — must be one of the account's senders. Default: sender_email. |
| confirmation_to_email | string | Where to send the 'campaign sent' confirmation. Default: sender_email. |
| track_in_google_analytics | boolean | Enable Google Analytics tracking (requires GA on your site). |
{
"name": "moosend_create_draft_campaign",
"title": "Create a draft campaign",
"description": "WRITE: create a regular (non-A/B) DRAFT campaign. It is NOT sent — sending stays a human action in Moosend. Give the content as html_content or a web_location URL. sender_email and reply_to_email must be senders in the account (see moosend_list_senders). Returns the new campaign's ID. Moosend: POST /campaigns/create.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"subject",
"sender_email",
"mailing_lists"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Campaign name."
},
"subject": {
"type": "string",
"minLength": 1,
"description": "Subject line."
},
"html_content": {
"type": "string",
"description": "Complete HTML body of the campaign."
},
"sender_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Sender email — must be one of the account's senders."
},
"web_location": {
"type": "string",
"format": "uri",
"description": "URL Moosend fetches the HTML from (CSS is inlined automatically)."
},
"mailing_lists": {
"type": "array",
"items": {
"type": "object",
"required": [
"mailing_list_id"
],
"properties": {
"segment_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Segment ID (an integer, from moosend_list_segments)."
},
"mailing_list_id": {
"type": "string",
"minLength": 1,
"description": "Mailing list ID."
}
}
},
"minItems": 1,
"description": "Target lists, each optionally narrowed to one segment."
},
"reply_to_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Reply-to email — must be one of the account's senders. Default: sender_email."
},
"confirmation_to_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Where to send the 'campaign sent' confirmation. Default: sender_email."
},
"track_in_google_analytics": {
"type": "boolean",
"description": "Enable Google Analytics tracking (requires GA on your site)."
}
}
},
"annotations": {
"title": "Create a draft campaign",
"destructiveHint": true
}
}Tools for Moosend, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How did my last email campaign do on opens and clicks?"; "How many active subscribers are on each of my mailing lists?"; "Which links got the most clicks in my latest campaign?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Moosend data. Free plan: 50 tool calls per month. Run moosend_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run moosend_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run moosend_upgrade without a plan: it returns both plans, each with a payment link for the user to open. moosend_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.