# Postalytics — how to use (mcp.ai)

Connect your Postalytics account and use 24 tools for marketing automation straight from your AI agent. Connect with your own API key. Direct Mail Automation software in the cloud with deep integration to CRM and workflows, making direct mail look, act and feel like a digital marketing channel.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/postalytics/add/account` — Tool to create a new sub-account in the Postalytics system. Use when you need to create a new account with a unique ID associated with the requester's user ID as parent. The response includes the API 
  - body: { phone?: string, company?: string, password: string, username: string, last_name: string, first_name: string, address_zip?: string, address_city?: string, address_state?: string, email_address?: string, address_street?: string }
- `POST https://api.mcp.ai/api/postalytics/add/contact` — Tool to add a contact to a specified contact list with their information. Use when you need to create a new contact or update an existing one on a contact list.
  - body: { phone?: string, company?: string, website?: string, last_name?: string, contact_id?: integer, first_name?: string, occupation?: string, address_zip?: string, var_field_1?: string, var_field_2?: string, var_field_3?: string, var_field_4?: string, var_field_5?: string, var_field_6?: string, var_field_7?: string, var_field_8?: string, var_field_9?: string, address_city?: string, created_date?: string, mobile_phone?: string, var_field_10?: string, var_field_11?: string, var_field_12?: string, var_field_13?: string, var_field_14?: string, var_field_15?: string, var_field_16?: string, var_field_17?: string, var_field_18?: string, var_field_19?: string, var_field_20?: string, var_field_21?: string, var_field_22?: string, var_field_23?: string, var_field_24?: string, var_field_25?: string, var_field_26?: string, var_field_27?: string, var_field_28?: string, var_field_29?: string, var_field_30?: string, var_field_31?: string, var_field_32?: string, var_field_33?: string, var_field_34?: string, var_field_35?: string, address_state?: string, email_address?: string, address_street?: string, address_street2?: string, contact_list_id: integer }
- `POST https://api.mcp.ai/api/postalytics/create/new/campaign` — Tool to create a new direct mail campaign in Postalytics. Use when you need to start a new campaign with specified sender details and template. Important: A template must be created and proofed before
  - body: { SenderZip: string, SenderCity: string, SenderName: string, PostageType: integer, SenderState: string, CreditTypeId: integer, SenderCountry?: string, DirectMailName: string, SenderAddress1: string, SenderAddress2?: string, TemplateFrontId: integer, TemplateEnvelopeId?: integer }
- `POST https://api.mcp.ai/api/postalytics/create/suppression/list` — Tool to create a new suppression list that can be used in campaigns to suppress contacts from being sent mail. Use when you need to create an empty suppression list. Note that contacts must be added s
  - body: { Name?: string, Country?: string }
- `POST https://api.mcp.ai/api/postalytics/create/suppression/list/contact` — Tool to create a new suppression contact on a specified suppression list. Use when you need to add a contact to a suppression list to prevent them from receiving mailings.
  - body: { Zip?: string, City?: string, Email?: string, Phone?: string, State?: string, Mobile?: string, Address?: string, Company?: string, Country?: string, Website?: string, list_id: integer, Address2?: string, LastName?: string, FirstName?: string, VarField1?: string, VarField2?: string, VarField3?: string, VarField4?: string, VarField5?: string, VarField6?: string, VarField7?: string, VarField8?: string, VarField9?: string, Occupation?: string, VarField10?: string, VarField11?: string, VarField12?: string, VarField13?: string, VarField14?: string, VarField15?: string, VarField16?: string, VarField17?: string, VarField18?: string, VarField19?: string, VarField20?: string, VarField21?: string, VarField22?: string, VarField23?: string, VarField24?: string, VarField25?: string, VarField26?: string, VarField27?: string, VarField28?: string, VarField29?: string, VarField30?: string, VarField31?: string, VarField32?: string, VarField33?: string, VarField34?: string, VarField35?: string }
- `POST https://api.mcp.ai/api/postalytics/create/template` — Tool to create a new template with full HTML for postcard or letter. Use when you need to create a template by providing complete HTML markup or image URLs for front/back. The template can be used for
  - body: { back?: string, html: string, name: string, size: string, count?: integer, front?: string, is_proofed?: boolean, font_family?: string, is_full_html?: boolean, is_double_sided?: boolean }
- `POST https://api.mcp.ai/api/postalytics/create/webhook` — Tool to create a new webhook to receive campaign event notifications from Postalytics. Use when you need to set up a webhook endpoint that will be notified about campaign events like sent, delivered, 
  - body: { url: string, name: string, events: string[] }
- `POST https://api.mcp.ai/api/postalytics/delete/account` — Tool to delete a Postalytics account and all associated campaigns, templates, and lists. Use when you need to permanently remove a sub account or sub user account. Cannot delete parent accounts.
  - body: { account_id: integer }
- `POST https://api.mcp.ai/api/postalytics/delete/campaign` — Tool to delete a campaign from the system. Use when you need to remove a campaign that is no longer needed.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/postalytics/delete/suppression/list` — Tool to delete a specified suppression list. Use when you need to remove a suppression list that is no longer needed.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/postalytics/delete/suppression/list/contact` — Tool to delete a specific contact from a suppression list. Use when you need to remove a contact from a suppression list in Postalytics.
  - body: { list_id: integer, contact_id: integer }
- `POST https://api.mcp.ai/api/postalytics/get/all/contact/lists` — Tool to retrieve all contact lists for an account. Use when you need to get a complete list of contact lists including their IDs, names, item counts, and creation dates.
- `POST https://api.mcp.ai/api/postalytics/get/all/contacts/on/a/list` — Tool to retrieve all contacts from a specified contact list with pagination support. Use when you need to get contacts from a list, with optional pagination using start offset and limit parameters.
  - body: { limit?: integer, start?: integer, list_id: integer }
- `POST https://api.mcp.ai/api/postalytics/get/all/drip/campaigns` — Tool to retrieve all triggered drip campaign names and endpoint IDs in the account. Use when you need to list all available drip campaigns for the authenticated user.
- `POST https://api.mcp.ai/api/postalytics/get/all/flows` — Tool to retrieve all flows for the requester's account. Use when you need to list or browse available flows.
- `POST https://api.mcp.ai/api/postalytics/get/all/webhooks` — Tool to retrieve all webhooks configured for the authenticated account. Use when you need to view webhook configurations for campaigns.
- `POST https://api.mcp.ai/api/postalytics/get/integrations` — Tool to retrieve all Connect integrations configured for the authenticated user's account. Use when you need to view CRM or data source integrations.
- `POST https://api.mcp.ai/api/postalytics/get/my/account` — Tool to retrieve basic account information for the authenticated user. Use when you need to get account details such as contact information, address, or API key.
- `POST https://api.mcp.ai/api/postalytics/get/suppression/list` — Tool to get the details of a suppression list based on the id supplied. Use when you need to retrieve information about a specific suppression list.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/postalytics/get/suppression/list/contact` — Tool to retrieve a specific contact from a suppression list. Use when you need to get details about a contact on a specific suppression list by their list ID and contact ID.
  - body: { offset?: integer, list_id: integer, contact_id: integer }
- `POST https://api.mcp.ai/api/postalytics/get/suppression/list/contacts` — Tool to get all contacts on a specified suppression list. Use when you need to retrieve contacts that are suppressed for a particular list.
  - body: { listId: integer, offset?: integer }
- `POST https://api.mcp.ai/api/postalytics/get/suppression/lists` — Tool to retrieve all suppression lists for the authenticated user. Use when you need to view or manage suppression lists. Returns all lists or a specific list when ID is provided.
  - body: { id?: integer }
- `POST https://api.mcp.ai/api/postalytics/update/account` — Tool to update an existing account in the Postalytics system. Use when you need to modify account information such as contact details, address, or credentials for an existing account.
  - body: { phone?: string, company?: string, password: string, username: string, last_name: string, account_id: integer, first_name: string, address_zip?: string, address_city?: string, address_state?: string, email_address?: string, address_street?: string }
- `POST https://api.mcp.ai/api/postalytics/update/suppression/list/contact` — Tool to update a suppression contact on the specified suppression list. Use when you need to modify contact information for a specific contact on a suppression list.
  - body: { Zip?: string, City?: string, Email?: string, Phone?: string, State?: string, Mobile?: string, Address?: string, Company?: string, Country?: string, Website?: string, list_id: integer, Address2?: string, LastName?: string, FirstName?: string, VarField1?: string, VarField2?: string, VarField3?: string, VarField4?: string, VarField5?: string, VarField6?: string, VarField7?: string, VarField8?: string, VarField9?: string, Occupation?: string, VarField10?: string, VarField11?: string, VarField12?: string, VarField13?: string, VarField14?: string, VarField15?: string, VarField16?: string, VarField17?: string, VarField18?: string, VarField19?: string, VarField20?: string, VarField21?: string, VarField22?: string, VarField23?: string, VarField24?: string, VarField25?: string, VarField26?: string, VarField27?: string, VarField28?: string, VarField29?: string, VarField30?: string, VarField31?: string, VarField32?: string, VarField33?: string, VarField34?: string, VarField35?: string, contact_id: integer }

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

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