# Postalytics — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/postalytics

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_postalytics?ms=1787291220000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/postalytics/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/postalytics/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/postalytics/skill.md
Postman collection (v2.1): https://mcp.ai/postalytics/postman.json

## Tools
- postalytics_add_account(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) — 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 
- postalytics_add_contact(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) — 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.
- postalytics_create_new_campaign(SenderZip: string, SenderCity: string, SenderName: string, PostageType: integer, SenderState: string, CreditTypeId: integer, SenderCountry?: string, DirectMailName: string, SenderAddress1: string, SenderAddress2?: string, TemplateFrontId: integer, TemplateEnvelopeId?: integer) — 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
- postalytics_create_suppression_list(Name?: string, Country?: string) — 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
- postalytics_create_suppression_list_contact(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) — 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.
- postalytics_create_template(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) — 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
- postalytics_create_webhook(url: string, name: string, events: string[]) — 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, 
- postalytics_delete_account(account_id: integer) — 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.
- postalytics_delete_campaign(id: integer) — Tool to delete a campaign from the system. Use when you need to remove a campaign that is no longer needed.
- postalytics_delete_suppression_list(id: integer) — Tool to delete a specified suppression list. Use when you need to remove a suppression list that is no longer needed.
- postalytics_delete_suppression_list_contact(list_id: integer, contact_id: integer) — Tool to delete a specific contact from a suppression list. Use when you need to remove a contact from a suppression list in Postalytics.
- 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.
- postalytics_get_all_contacts_on_a_list(limit?: integer, start?: integer, list_id: integer) — 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.
- 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.
- postalytics_get_all_flows() — Tool to retrieve all flows for the requester's account. Use when you need to list or browse available flows.
- postalytics_get_all_webhooks() — Tool to retrieve all webhooks configured for the authenticated account. Use when you need to view webhook configurations for campaigns.
- 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.
- 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.
- postalytics_get_suppression_list(id: integer) — 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.
- postalytics_get_suppression_list_contact(offset?: integer, list_id: integer, contact_id: integer) — 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.
- postalytics_get_suppression_list_contacts(listId: integer, offset?: integer) — Tool to get all contacts on a specified suppression list. Use when you need to retrieve contacts that are suppressed for a particular list.
- postalytics_get_suppression_lists(id?: integer) — 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.
- postalytics_update_account(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) — 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.
- postalytics_update_suppression_list_contact(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) — 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.

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

## Links
Docs: https://mcp.ai/docs/mcps/postalytics
Website: https://mcp.ai/mcps/postalytics