Provides email deliverability data from Mailgun, including bounces, spam complaints, suppression lists, delivery statistics, and campaign information.
Provides email deliverability data from SendGrid, including bounces, spam complaints, suppression lists, delivery statistics, and campaign information.
Provides email deliverability data from SparkPost, including bounces, spam complaints, suppression lists, delivery statistics, and campaign information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ParseBounce MCP Server Why did our welcome emails bounce yesterday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that gives AI assistants access to your email deliverability data — bounces, spam complaints, suppression lists, delivery stats and campaigns — across AWS SES, SendGrid, Mailgun, SparkPost, Postmark and Mandrill.
Ask Claude, Cursor or any MCP client things like:
"Why did our welcome emails bounce yesterday?" "Is support@acme.com on the suppression list?" "Compare our bounce rate this week against last week." "What's our Gmail delivery rate?"
Powered by ParseBounce — email bounce and complaint tracking for any email provider.
Create an API key at parsebounce.com/dashboard/profile, then add this to your MCP client config:
{
"mcpServers": {
"parsebounce": {
"command": "npx",
"args": ["-y", "@parsebounce/mcp-server"],
"env": {
"PARSEBOUNCE_API_KEY": "pb_live_..."
}
}
}
}Restart your client. That's it — no install, no build step.
Client | Config file |
Claude Desktop (macOS) |
|
Claude Desktop (Windows) |
|
Claude Code |
|
Cursor |
|
VS Code (Copilot) |
|
Windsurf |
|
Continue.dev |
|
Claude Desktop, Claude Code and ChatGPT support remote MCP with OAuth — no npm package and no API key needed. Point them at:
https://api.parsebounce.com/mcpYou'll be asked to sign in to ParseBounce and approve access. Use this package when your client only speaks stdio.
Related MCP server: vaemail
Tool | What it does |
| List projects you have access to (start here for project IDs) |
| Suppression status plus the full delivery/bounce/complaint history for an address |
| Check suppression status for up to 100 addresses at once |
| Delivery, bounce and complaint rates for a project |
| Recent bounces with reasons |
| Messages by recipient domain — diagnose Gmail/Yahoo/Outlook issues |
| Messages by campaign or batch identifier |
| Full event timeline for one message |
| Compare metrics between two time periods to spot trends |
Tool | What it does |
| List suppressed addresses |
| Block an address from receiving mail |
| Unblock an address |
Tool | What it does |
| Crowdsourced risk level (safe/risky/bad) for an address before you send |
| Aggregate bounce and complaint data for a domain |
Tool | What it does |
| Verified sender domains and addresses |
| List campaigns, optionally filtered by status |
| Sent / opened / clicked / bounced counts for a campaign |
| Contact lists |
| Email templates |
| Find a contact by address within a list |
| Current month usage against plan limits |
| Sending volume over time (sent vs failed) |
| Recent transactional sends |
| Send a single transactional email |
| Create a campaign and start sending |
| Control a running campaign |
Tools that send mail or change state are annotated so your client asks for confirmation first.
Variable | Default | Purpose |
| — | Required. Your |
|
| Override the endpoint |
|
| Request timeout in ms |
| — | Set to |
The key can also be passed as --api-key <key>. Run with --help for a config example.
This package is a thin bridge, not a reimplementation:
MCP client ──stdio (JSON-RPC)──▶ @parsebounce/mcp-server ──HTTPS──▶ api.parsebounce.com/mcpIt reads newline-delimited JSON-RPC from stdin, forwards each request to the ParseBounce MCP endpoint with your API key, and writes responses back to stdout. Every tool runs server-side, which means:
No version drift — new tools appear without upgrading this package
Zero runtime dependencies — nothing but Node's built-in fetch
Nothing stored locally — your key goes straight to the API over TLS
Requires Node.js 18 or newer.
Your API key grants full access to your ParseBounce account. Keep it in your MCP client's
env block rather than in a committed file, and revoke it from the
dashboard if it leaks. Keys are transmitted
only to api.parsebounce.com over HTTPS and are never written to disk or logged.
MIT © ParseBounce
This server cannot be deployed
Email deliverability monitoring and sending: bounces, complaints, suppression, campaigns.
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
AI-controlled email ops for campaigns, contacts, segments, analytics, and sending.
Email infrastructure for AI agents: send, read replies as threads, campaigns, per-key limits.
