@poststack.dev/mcp

Model Context Protocol server for the PostStack Email API — an EU-hosted, GDPR-compliant email API for AI agents. Lets assistants like Claude, Cursor, and Windsurf send transactional email, draft replies from inbound threads, run deliverability checks, summarise broadcasts, and more — through one curated tool surface.

102 tools, 5 prompts, and 5 resources, all surfaced over either the local stdio bin or the hosted HTTP transport at https://api.poststack.dev/mcp.

Full MCP reference: poststack.dev/docs/mcp.

Quickstart

Hosted (Claude.ai connector, hosted agents)

Point any MCP client at:

https://api.poststack.dev/mcp

Authenticate with your PostStack API key as a Bearer token. No local install required.

Claude Desktop (stdio)

{
	"mcpServers": {
		"poststack": {
			"command": "npx",
			"args": ["-y", "@poststack.dev/mcp"],
			"env": {
				"POSTSTACK_API_KEY": "sk_live_your_api_key_here"
			}
		}
	}
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

You can also generate the snippet with:

npx @poststack.dev/mcp --print-config claude-desktop

Claude Code

claude mcp add poststack -e POSTSTACK_API_KEY=sk_live_your_api_key_here -- npx -y @poststack.dev/mcp

Cursor / VS Code

Same JSON shape as Claude Desktop, in the editor's MCP settings.

Environment variables

What the agent gets

The MCP server doesn't just mirror the REST API — it gives agents the context tools they need to make sensible decisions: spam-checking before sending, deliverability summaries before picking a from-address, engagement scores before re-engaging a contact.

Worked example: welcome email

The draft_welcome_email prompt walks an agent through:

1. get_contact_by_email — confirm the contact and capture properties
2. list_templates — pick a published welcome template
3. render_template — render with the contact's properties; surface any missing variables
4. suggest_from_address — pick a verified from-address based on existing mailboxes
5. preview_email — render + spam check + deliverability warnings in one round-trip
6. send_email — only if preview passed

Other prompts cover re-engagement, follow-up campaigns to non-clickers, broadcast summaries, and inbound triage.

Reference

Tools (102)

emails

• send_email — Send a single transactional email immediately, or schedule it for a future time.
• send_batch_emails — Send multiple emails in a single batch request (up to 100 per call).
• list_emails — List previously-sent emails with optional filters and pagination.
• get_email — Get full details and event timeline for a specific email by id.
• cancel_email — Cancel a scheduled email that has not yet entered the sending pipeline.
• reschedule_email — Reschedule a scheduled email to a new send time.
• lint_email — Run a Rspamd-backed spam pre-flight on a draft email and return the score, action, and per-rule symbols.
• preview_email — Render + lint + measure an email in one shot WITHOUT sending it.

email-validations

• validate_email — Check whether an email address is safe to send to BEFORE create_contact or send_email.
• validate_email_batch — Validate up to 100 email addresses in a single call. Same checks as validate_email per address.

contacts

• create_contact — Create a new contact (person who can receive emails / broadcasts).
• list_contacts — List contacts with optional search and segment filtering.
• get_contact — Get full details of a contact by id.
• update_contact — Update an existing contact's name, properties, or subscription state.
• delete_contact — Permanently delete a contact (irreversible — use unsubscribe_contact for opt-outs).
• unsubscribe_contact — Mark a contact as unsubscribed from all email (preserves the contact record).
• get_contact_by_email — Look up a contact by their email address.
• get_contact_activity — Get a contact's recent email-event timeline grouped by event type (sent / delivered / opened / clicked / bounced / complained / failed).
• get_engagement_summary — Get a single contact's engagement summary: segment + lifetime counts + open / click rates + last open / click + top tags.
• search_contacts — Search contacts with filters (segment, engagement, unsubscribed) and a fuzzy query across email/first_name/last_name. Adds a match_reason on each row indicating which field matched the query.

templates

• create_template — Create a new email template with {{variable}} placeholders.
• list_templates — List email templates.
• get_template — Get a template's full body, subject and variables.
• update_template — Update an existing template's name, subject, body or variable list.
• delete_template — Permanently delete a template (irreversible).
• publish_template — Mark a template as published so it can be referenced by send_email.
• unpublish_template — Mark a template as unpublished so it cannot be sent.
• duplicate_template — Create a copy of an existing template (new id, same body, name suffixed " (copy)").
• render_template — Server-side render a template with the provided variables.

broadcasts

• create_broadcast — Create a draft broadcast targeted at a segment.
• list_broadcasts — List broadcasts.
• get_broadcast — Get a broadcast's details and aggregate delivery stats.
• update_broadcast — Edit a draft broadcast in place. Only draft broadcasts can be updated.
• send_broadcast — Dispatch a draft broadcast to its segment immediately.
• cancel_broadcast — Cancel a queued or sending broadcast.
• broadcast_performance — Get broadcast performance — either for one broadcast (variant breakdown if A/B) or for a leaderboard ranked by a chosen metric.
• find_non_clickers — List contacts who received a broadcast but did NOT click any tracked link in it.

segments

• create_segment — Create a static contact segment (manually-managed list).
• list_segments — List contact segments.
• get_segment — Get a segment's details and member count.
• update_segment — Rename an existing segment.
• delete_segment — Delete a segment definition. Contacts in it are NOT deleted.
• add_contacts_to_segment — Add one or more contacts to a segment.
• remove_contact_from_segment — Remove a single contact from a segment.

workflows

• list_workflows — List all workflows (event-triggered automation pipelines) defined for this team.
• get_workflow — Get full details of a workflow including its ordered steps.
• create_workflow — Create a new workflow shell (no steps yet, status=draft).
• update_workflow — Update a workflow's name, trigger type, or trigger config.
• delete_workflow — Permanently delete a workflow and its steps. In-flight runs are NOT cancelled — they finish on the live engine.
• add_workflow_step — Append (or insert) a step to a workflow.
• update_workflow_step — Update a step's config. Cannot change step_type or position — delete and re-add for that.
• remove_workflow_step — Remove a step from a workflow. Remaining steps keep their positions (gaps are allowed).
• activate_workflow — Move a workflow from draft/paused to active so new trigger events start runs.
• pause_workflow — Pause an active workflow so new trigger events DO NOT start runs. In-flight runs continue to completion.
• trigger_workflow — Manually fire a workflow for a specific contact. Works for any trigger_type, but most useful for "manual" workflows.

signup-forms

• list_signup_forms — List embeddable signup forms.
• get_signup_form — Get full details of a signup form including its fields, target segment, and submission count.
• create_signup_form — Create an embeddable signup form. Submissions create a contact and optionally add them to a segment / subscription topic.
• update_signup_form — Update a signup form's fields, target segment/topic, messaging, or active state.
• delete_signup_form — Permanently delete a signup form. Embedded copies on existing pages will fail with 404.

domains

• create_domain — Add a new sending domain to PostStack.
• list_domains — List sending domains.
• get_domain — Get domain details including DNS records and verification status.
• verify_domain — Trigger DNS verification for a domain.
• update_domain — Update domain settings (tracking, TLS, inbound, BIMI, sending stream).
• delete_domain — Permanently delete a sending domain (irreversible — historical email records remain).
• check_deliverability — Check whether a from-address is safe to send from RIGHT NOW.

mailboxes

• create_mailbox — Provision a mailbox (IMAP/SMTP inbox) on a verified domain.
• list_mailboxes — List mailboxes across all domains.
• get_mailbox — Get a mailbox's metadata (status, quota, last login).
• update_mailbox — Update a mailbox's display name, quota, status, or webhook setting.
• delete_mailbox — Permanently delete a mailbox and all its stored mail.
• change_mailbox_password — Reset a mailbox's IMAP/SMTP password.
• suggest_from_address — Suggest sensible from-addresses for a given purpose, drawn from the team's verified domains + existing mailboxes.

inbound-emails