# Laposta — how to use (mcp.ai)

Connect your Laposta account and use 25 tools for email newsletters straight from your AI agent. Connect with your own API key. Dutch newsletter app (email marketing) that makes it exceptionally easy to send professional newsletters.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/laposta/campaign/get/all` — Retrieve all email campaigns from your Laposta account. Use this tool to list all campaigns with their configuration, delivery status, and analytics settings. Returns campaign details including sender
- `POST https://api.mcp.ai/api/laposta/field/create` — Tool to create a custom field for a mailing list to define subscriber attributes. Use when you need to add custom fields like text, numeric, date, or select fields to a list. For select fields (select
  - body: { name: string, in_form: boolean, in_list: boolean, list_id: string, options?: string[], datatype: string, required: boolean, defaultvalue?: string, datatype_display?: string }
- `POST https://api.mcp.ai/api/laposta/field/delete` — Tool to permanently remove a custom field from a mailing list. Use when you need to delete a field that is no longer needed.
  - body: { list_id: string, field_id: string }
- `POST https://api.mcp.ai/api/laposta/field/get` — Tool to retrieve specific field details by field_id. Use when you need to fetch complete information about a custom field including its configuration, data type, and available options.
  - body: { list_id: string, field_id: string }
- `POST https://api.mcp.ai/api/laposta/field/get/all` — Tool to retrieve all fields for a specific list in Laposta. Use when you need to see all field definitions, metadata, and settings for a list.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/field/update` — Tool to modify field configuration in a Laposta list. Use when you need to update field properties such as name, datatype, required status, or display settings. WARNING: Modifying datatype removes all
  - body: { name?: string, in_form?: boolean, in_list?: boolean, list_id: string, datatype?: string, field_id: string, required?: boolean, defaultvalue?: string, options_full?: object[], datatype_display?: string }
- `POST https://api.mcp.ai/api/laposta/get/segment` — Tool to retrieve specific segment details by segment_id. Use when you need to fetch complete information about a segment including its name, definition criteria, and timestamps.
  - body: { list_id: string, segment_id: string }
- `POST https://api.mcp.ai/api/laposta/list/clear/members` — Tool to clear all active members from a list. Use when you need to remove all active member relationships while preserving the list itself. The operation is permanent and cannot be undone.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/list/create` — Tool to create a new mailing list in Laposta to manage email subscribers. Use when you need to create a new list with zero members.
  - body: { name: string, locked?: boolean, remarks?: string, subscribe_notification_email?: string, unsubscribe_notification_email?: string }
- `POST https://api.mcp.ai/api/laposta/list/delete` — Permanently deletes a mailing list from Laposta. This action is irreversible - the list and all its configuration (including notification settings and metadata) will be permanently removed. Members ar
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/list/get` — Tool to retrieve specific list details by list_id. Use when you need to fetch complete information about a mailing list including its metadata, state, notification settings, and member statistics.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/list/get/all` — Tool to retrieve all mailing lists from your Laposta account. Use when you need to view all lists including both active and deleted ones.
- `POST https://api.mcp.ai/api/laposta/list/update` — Tool to modify list properties such as name, remarks, or notification emails. Use when you need to update an existing mailing list's configuration.
  - body: { name?: string, locked?: boolean, list_id: string, remarks?: string, subscribe_notification_email?: string, unsubscribe_notification_email?: string }
- `POST https://api.mcp.ai/api/laposta/member/create` — Tool to add a new subscriber relationship to a list with custom fields and tracking info. Use when you need to create a new member in a list or update an existing member if upsert is enabled.
  - body: { ip: string, email: string, list_id: string, options?: object, source_url?: string, custom_fields?: object }
- `POST https://api.mcp.ai/api/laposta/member/delete` — Tool to permanently remove a member from a list. Use when you need to delete a member by their ID or email address.
  - body: { list_id: string, member_id: string }
- `POST https://api.mcp.ai/api/laposta/member/get` — Tool to retrieve specific member details by member_id or email. Use when you need to get comprehensive information about a member from a list, including their status, registration details, and custom 
  - body: { list_id: string, member_id: string }
- `POST https://api.mcp.ai/api/laposta/member/get/all` — Tool to retrieve all members from a specified Laposta mailing list. Use when you need to list or view all contacts in a list. Optionally filter by member state (active, unsubscribed, or cleaned).
  - body: { state?: string, list_id: string }
- `POST https://api.mcp.ai/api/laposta/member/update` — Tool to modify member data, status, or custom fields in a Laposta list. Use when updating existing member information or managing subscription state. Supports partial updates (only modified fields nee
  - body: { email?: string, state?: string, list_id: string, member_id: string, custom_fields?: object }
- `POST https://api.mcp.ai/api/laposta/report/get/all` — Tool to retrieve performance metrics for all campaigns. Use when you need campaign statistics including opens, clicks, bounces, complaints, and unsubscribes.
- `POST https://api.mcp.ai/api/laposta/segment/get/all` — Tool to retrieve all segments from a mailing list. Use when you need to list or browse segments within a specific list.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/webhook/create` — Tool to register a new webhook for list events in Laposta. Use when you need to receive real-time notifications for subscriber events like subscriptions, modifications, or deactivations.
  - body: { url: string, event: string, blocked?: boolean, list_id: string }
- `POST https://api.mcp.ai/api/laposta/webhook/delete` — Tool to permanently remove a webhook. Use when you need to delete a webhook from a list. Pending webhook requests are completed before deletion.
  - body: { list_id: string, webhook_id: string }
- `POST https://api.mcp.ai/api/laposta/webhook/get` — Tool to retrieve specific webhook details by webhook_id. Use when you need to inspect webhook configuration including event type, URL, and status.
  - body: { list_id: string, webhook_id: string }
- `POST https://api.mcp.ai/api/laposta/webhook/get/all` — Tool to retrieve all webhooks for a specific list. Use when you need to view all webhooks configured for a particular list.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/laposta/webhook/update` — Tool to modify webhook configuration including URL, event type, or blocked status. Use when you need to update an existing webhook's settings.
  - body: { url?: string, event?: string, blocked?: boolean, list_id: string, webhook_id: string }

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

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