Postalytics MCP server
44 operations0 webhooks
Manage direct mail campaigns, contacts, flows, templates, suppression lists, and outbound webhook configurations with the Postalytics API.
Try Postalytics with your agent
Connect Postalytics, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Postalytics on my account, then run one read-only example and show me the result.
Postalytics tools and triggers
Tools are what your agent can do in Postalytics through Corsair's MCP server. Triggers are the Postalytics events a routine can start from.
Campaigns
- Create New CampaignWrite
create new campaign
campaigns.createNewCampaign
- Delete CampaignDestructive
delete campaign
campaigns.deleteCampaign
- Get All CampaignsRead-only
List campaigns with delivery stats; each has campaign_id and the drop_id the other campaign operations take
campaigns.getAllCampaigns
- Get All Drip CampaignsRead-only
get all drip campaigns
campaigns.getAllDripCampaigns
- Get CampaignRead-only
get campaign
campaigns.getCampaign
- Get Campaign EventsRead-only
get campaign events
campaigns.getCampaignEvents
- Get Campaign StatsRead-only
get campaign stats
campaigns.getCampaignStats
- Get Contact EventRead-only
get contact event
campaigns.getContactEvent
- Update Campaign StatusDestructive
Switch a triggered drip or automated file campaign between test mode and live mode. In live mode its sends print and mail real pieces billed per piece
campaigns.updateCampaignStatus
Contacts
- Create Contact On ListWrite
create contact on list
contacts.createContactOnList
- Delete ContactDestructive
delete contact
contacts.deleteContact
- Get All Contact ListsRead-only
get all contact lists
contacts.getAllContactLists
- Get ContactRead-only
get contact
contacts.getContact
- Get Contacts On ListRead-only
get contacts on list
contacts.getContactsOnList
- Update Contact On ListWrite
update contact on list
contacts.updateContactOnList
Account
- Create New AccountWrite
Create a sub-account under the connected account; returns its id and creation date (the API key is left out)
account.createNewAccount
- Delete AccountDestructive
delete account
account.deleteAccount
- Get AccountRead-only
get account
account.getAccount
- Get My AccountRead-only
Get the connected account profile (credentials are left out)
account.getMyAccount
- Update AccountWrite
update account
account.updateAccount
Suppression Contacts
- Create Suppression List ContactWrite
create suppression list contact
suppressionContacts.createSuppressionListContact
- Delete Suppression List ContactDestructive
delete suppression list contact
suppressionContacts.deleteSuppressionListContact
- Get Suppression List ContactRead-only
get suppression list contact
suppressionContacts.getSuppressionListContact
- Get Suppression List ContactsRead-only
get suppression list contacts
suppressionContacts.getSuppressionListContacts
- Update Suppression List ContactWrite
Update a suppression list contact. Address fields cannot be changed; Postalytics rejects them
suppressionContacts.updateSuppressionListContact
Webhooks
- Create WebhookWrite
create webhook
webhooks.createWebhook
- Delete WebhookDestructive
Unsubscribe a campaign's webhook; Postalytics keeps the record with is_subscribed 0
webhooks.deleteWebhook
- Get All WebhooksRead-only
get all webhooks
webhooks.getAllWebhooks
- Get WebhookRead-only
get webhook
webhooks.getWebhook
- Update WebhookWrite
update webhook
webhooks.updateWebhook
Flows
- Enroll Contact To FlowDestructive
Enroll a recipient in a flow; a live flow prints and mails its pieces to them, billed per piece
flows.enrollContactToFlow
- Get All FlowsRead-only
get all flows
flows.getAllFlows
- Get FlowRead-only
get flow
flows.getFlow
- Unenroll Contact From FlowWrite
unenroll contact from flow
flows.unenrollContactFromFlow
Suppression Lists
- Create Suppression ListWrite
create suppression list
suppressionLists.createSuppressionList
- Delete Suppression ListDestructive
delete suppression list
suppressionLists.deleteSuppressionList
- Get Suppression ListRead-only
get suppression list
suppressionLists.getSuppressionList
- Get Suppression ListsRead-only
get suppression lists
suppressionLists.getSuppressionLists
Templates
- Create TemplateWrite
create template
templates.createTemplate
- Delete TemplateDestructive
delete template
templates.deleteTemplate
- Get All TemplatesRead-only
get all templates
templates.getAllTemplates
- Get TemplateRead-only
get template
templates.getTemplate
Login
- Create Login LinkWrite
Create a short-lived auto-login link for the connected account, optionally landing on a page such as dashboard
login.createLoginLink
- Send MailDestructive
Send direct mail, which may incur charges and cannot be recalled
mail.sendMail
Connect Postalytics to Claude, ChatGPT or Cursor
- 1
Connect Postalytics in Corsair
Add your Postalytics API key once in Corsair. Corsair stores the credential encrypted and makes the Postalytics API calls for your agent, so it never goes into a prompt or a config file. Connect Postalytics
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Postalytics. On a ChatGPT personal plan, connect Postalytics here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Postalytics's read and write operations run right away and its 10 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/postalytics, add the Postalytics plugin, and connect with an API key. Then call methods like corsair.postalytics.api.account.createNewAccount() from your app. Corsair keeps each tenant isolated.
Yes. Postalytics requires an API key from your Postalytics account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Postalytics, GitHub, Notion, Stripe, and the rest. Trigger Postalytics from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for manage direct mail campaigns, contacts, flows, templates, suppression lists, and outbound webhook configurations with the Postalytics API. Common builds include sync jobs, admin tooling, and agents that call Postalytics APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Postalytics API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/postalytics in the open repo. When Postalytics ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Postalytics data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Postalytics data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Postalytics on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 10 destructive Postalytics operations. You can change a link's mode at hub.corsair.dev/me.