laposta_add_member

WRITE: add one email address to a mailing list (subscribe). On a double opt-in list Laposta sends the confirmation email to that address. The address must have given consent. With upsert, an existing active member's fields are overwritten; an unsubscribed member is re-activated unless suppress_reactivation is set.

destructive

Argument	Type	Description
ip*	string	IP address the signup came from (required by Laposta; use the signup source's address, or your own server's if it was entered by staff).
email*	string
upsert	boolean	Overwrite the fields if the address is already an active member (default false: error).
list_id*	string	The list id (from laposta_list_lists).
source_url	string	URL the signup came from.
custom_fields	object	Custom field values keyed by the field's custom_name (the variable name shown by laposta_list_fields). Multi-choice fields take an array of option values.
suppress_reactivation	boolean	With upsert: do not re-activate an unsubscribed member.
suppress_email_notification	boolean	Do not send the list's signup notification email.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "email",
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "pattern": "^[0-9a-fA-F:.]+$",
      "maxLength": 45,
      "minLength": 3,
      "description": "IP address the signup came from (required by Laposta; use the signup source's address, or your own server's if it was entered by staff)."
    },
    "email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 320,
      "minLength": 3
    },
    "upsert": {
      "type": "boolean",
      "description": "Overwrite the fields if the address is already an active member (default false: error)."
    },
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    },
    "source_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "URL the signup came from."
    },
    "custom_fields": {
      "type": "object",
      "description": "Custom field values keyed by the field's custom_name (the variable name shown by laposta_list_fields). Multi-choice fields take an array of option values.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 5000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 500
            },
            "maxItems": 100
          }
        ]
      }
    },
    "suppress_reactivation": {
      "type": "boolean",
      "description": "With upsert: do not re-activate an unsubscribed member."
    },
    "suppress_email_notification": {
      "type": "boolean",
      "description": "Do not send the list's signup notification email."
    }
  }
}

laposta_create_campaign

WRITE: create a new regular campaign (a draft: it is NOT filled, scheduled or sent). Fill it with laposta_set_campaign_content, check it with laposta_send_test_email and send it in the Laposta app. The from_email must be an approved sender address of the account.

Argument	Type	Description
name*	string	Internal campaign name.
subject*	string	Subject line.
list_ids*	array	Recipients: list ids and optionally segment ids.
reply_to	string	Reply-to address.
from_name*	string	Sender name.
from_email*	string	Sender email address (must be an approved sender in Laposta).
previewtext	string	Preview text (max 120 characters).
google_analytics	boolean	Link Google Analytics tracking.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "subject",
    "from_name",
    "from_email",
    "list_ids"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Internal campaign name."
    },
    "subject": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Subject line."
    },
    "list_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1,
        "description": "Laposta id (a short alphanumeric string, e.g. BaImMu3JZA)."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Recipients: list ids and optionally segment ids."
    },
    "reply_to": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 320,
      "minLength": 3,
      "description": "Reply-to address."
    },
    "from_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Sender name."
    },
    "from_email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 320,
      "minLength": 3,
      "description": "Sender email address (must be an approved sender in Laposta)."
    },
    "previewtext": {
      "type": "string",
      "maxLength": 120,
      "description": "Preview text (max 120 characters)."
    },
    "google_analytics": {
      "type": "boolean",
      "description": "Link Google Analytics tracking."
    }
  }
}

laposta_get_campaign

Get one campaign: name, subject, preview text, sender, reply-to, recipients, delivery moments and web version URL.

read-only

Argument	Type	Description
campaign_id*	string	The campaign id (from laposta_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    }
  }
}

laposta_get_campaign_content

Get the plain-text content of a campaign (and its import_url if it was imported). Set include_html to also get the full HTML (large).

read-only

Argument	Type	Description
campaign_id*	string	The campaign id (from laposta_list_campaigns).
include_html	boolean	Also return the HTML body (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    },
    "include_html": {
      "type": "boolean",
      "description": "Also return the HTML body (default false)."
    }
  }
}

laposta_get_campaign_history

Recipient events of one campaign (delivered, opened, clicked, bounced, unsubscribed ...), newest first by default, optionally within a date range. Paged by cursor. For totals use laposta_get_report.

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100; a large page can be cut at 50,000 characters and lose its next_cursor).
order	string	Sort by event date (default desc).
cursor	string	Cursor: pass the previous reply's next_cursor unchanged, with the same filters.
campaign_id*	string	The campaign id (from laposta_list_campaigns).
event_date_to	string	Events before this moment, exclusive.
event_date_from	string	Events from this moment, inclusive.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100; a large page can be cut at 50,000 characters and lose its next_cursor)."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort by event date (default desc)."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Cursor: pass the previous reply's next_cursor unchanged, with the same filters."
    },
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    },
    "event_date_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})?)?$",
      "description": "Events before this moment, exclusive."
    },
    "event_date_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})?)?$",
      "description": "Events from this moment, inclusive."
    }
  }
}

laposta_get_list

Get one mailing list: name, state, notification addresses and member counts.

read-only

Argument	Type	Description
list_id*	string	The list id (from laposta_list_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    }
  }
}

laposta_get_member

Get one member of a list by member id or email address: state, signup/confirm dates and custom field values.

read-only

Argument	Type	Description
member*	string	The member id OR the member's email address.
list_id*	string	The list id (from laposta_list_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "member"
  ],
  "properties": {
    "member": {
      "type": "string",
      "maxLength": 320,
      "minLength": 1,
      "description": "The member id OR the member's email address."
    },
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    }
  }
}

laposta_get_member_history

The event history of one member (subscribed, confirmed, opened, clicked, bounced, unsubscribed, automations ...), newest first by default. Optionally limited to one campaign or a date range. Paged by cursor.

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100; a large page can be cut at 50,000 characters and lose its next_cursor).
order	string	Sort by event date (default desc).
cursor	string	Cursor: pass the previous reply's next_cursor unchanged, with the same filters.
member*	string	The member id OR the member's email address.
list_id*	string	The list id (from laposta_list_lists).
campaign_id	string	Only events of this campaign.
event_date_to	string	Events before this moment, exclusive.
event_date_from	string	Events from this moment, inclusive.

laposta_get_report

Result figures of one campaign: sent, accepted, unique opens and clicks, bounces, complaints, unsubscribes and their ratios.

read-only

Argument	Type	Description
campaign_id*	string	The campaign id (from laposta_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    }
  }
}

laposta_list_campaigns

List the account's campaigns (name, subject, sender, recipient lists, delivery moments). Use limit/offset to page.

read-only

Argument	Type	Description
limit	integer	Items to return (default 100, max 500).
offset	integer	Items to skip (default 0). Pass the previous reply's next_offset.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items to return (default 100, max 500)."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Items to skip (default 0). Pass the previous reply's next_offset."
    }
  }
}

laposta_list_fields

List the custom fields of a mailing list (name, custom_name used as the key in custom_fields, datatype, required, options). Call this before adding or updating a member.

read-only

Argument	Type	Description
list_id*	string	The list id (from laposta_list_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    }
  }
}

laposta_list_lists

List all mailing lists of the Laposta account with member counts (active, unsubscribed, cleaned). Use the list_id in the other tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

laposta_list_members

List the members (subscribers) of a mailing list, one page at a time. Filter by state, free-text search (email and field values) or label. Contains personal data: only fetch what the task needs.

read-only

Argument	Type	Description
label	string	Only members with this label (by name).
limit	integer	Items per page (default 25, max 100; a large page can be cut at 50,000 characters and lose its next_cursor).
order	string	Sort direction for order_by (default asc).
state	string	Only members in this state (default: all).
cursor	string	Cursor: pass the previous reply's next_cursor unchanged, with the same filters.
search	string	Only members containing this text in the email or any text/number/choice field.
list_id*	string	The list id (from laposta_list_lists).
order_by	string	email, signup_date, or a text field's custom_name (comma-separated for several).

laposta_list_reports

Result figures of all campaigns: sent, accepted, opened, clicked, bounced, unsubscribed, with ratios. Use limit/offset to page.

read-only

Argument	Type	Description
limit	integer	Items to return (default 100, max 500).
offset	integer	Items to skip (default 0). Pass the previous reply's next_offset.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items to return (default 100, max 500)."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Items to skip (default 0). Pass the previous reply's next_offset."
    }
  }
}

laposta_list_segments

List the segments of a mailing list (a segment id can be a campaign recipient together with its list).

read-only

Argument	Type	Description
list_id*	string	The list id (from laposta_list_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    }
  }
}

laposta_send_test_email

WRITE: send a test copy of a campaign (it must have content and not be sent yet) to ONE email address. Does not send the campaign to its recipients.

Argument	Type	Description
email*	string	Where to send the test.
campaign_id*	string	The campaign id (from laposta_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 320,
      "minLength": 3,
      "description": "Where to send the test."
    },
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    }
  }
}

laposta_set_campaign_content

WRITE: replace a campaign's content with your HTML, or let Laposta import it from a URL (html wins if both are given). Does not send anything. The reply's report lists problems Laposta found (javascript, missing unsubscribe link, missing images).

destructive

Argument	Type	Description
html	string	The complete HTML of the email.
import_url	string	A public URL Laposta fetches the HTML from.
inline_css	boolean	Inline the CSS.
campaign_id*	string	The campaign id (from laposta_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "html": {
      "type": "string",
      "maxLength": 2000000,
      "minLength": 1,
      "description": "The complete HTML of the email."
    },
    "import_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "A public URL Laposta fetches the HTML from."
    },
    "inline_css": {
      "type": "boolean",
      "description": "Inline the CSS."
    },
    "campaign_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The campaign id (from laposta_list_campaigns)."
    }
  }
}

laposta_update_member

WRITE: change a member's custom field values and/or email address, or unsubscribe the member (state: unsubscribed). Only the fields you pass change. Re-subscribing a person is not offered here: do it in the Laposta app or with laposta_add_member upsert only when they asked for it.

destructive

Argument	Type	Description
email	string	A new email address for this member.
state	string	Set to unsubscribed to unsubscribe the member.
member*	string	The member id OR the member's email address.
list_id*	string	The list id (from laposta_list_lists).
custom_fields	object	Custom field values keyed by the field's custom_name (the variable name shown by laposta_list_fields). Multi-choice fields take an array of option values.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "member"
  ],
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[^\\s@]+@[^\\s@]+$",
      "maxLength": 320,
      "minLength": 3,
      "description": "A new email address for this member."
    },
    "state": {
      "type": "string",
      "const": "unsubscribed",
      "description": "Set to unsubscribed to unsubscribe the member."
    },
    "member": {
      "type": "string",
      "maxLength": 320,
      "minLength": 1,
      "description": "The member id OR the member's email address."
    },
    "list_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The list id (from laposta_list_lists)."
    },
    "custom_fields": {
      "type": "object",
      "description": "Custom field values keyed by the field's custom_name (the variable name shown by laposta_list_fields). Multi-choice fields take an array of option values.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 5000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 500
            },
            "maxItems": 100
          }
        ]
      }
    }
  }
}

Laposta MCP by usefulapi

Try it

laposta_add_member Destructive

Laposta MCP by usefulapi

Try it

laposta_add_member Destructive

Tools (18)