Model Context Protocol

Talk to your email data with AI

Get instant answers about email delivery and bounces. Stop clicking through charts and filters — get the answer in one question.

Get Started
ChatGPT
with ParseBounce MCP

Why is my email to sarah@acme.co bouncing?

I checked the email history for sarah@acme.co. Here's what I found:

!Suppressed - Hard Bounce

Bounce reason: "550 5.1.1 User unknown"

First bounced: January 12, 2025

This email address doesn't exist at acme.co. The recipient may have left the company or the address was entered incorrectly.

What's my overall deliverability this week?

Here are your deliverability stats for the last 7 days:

15,842
Total Sent
98.2%
Delivered
1.6%
Bounced
0.02%
Complaints

10 powerful tools at your fingertips

Everything you need to monitor and manage email delivery, accessible through conversation.

check_email

Debug Delivery Issues

Check any email address - see if it's suppressed, view message history, and understand why emails fail.

get_deliverability_stats

Monitor Health

Get delivery rates, bounce rates, and complaint rates. Track your sender reputation over time.

list_recent_bounces

Track Bounces

See recent bounced emails with detailed bounce reasons. Identify patterns and problematic domains.

list_suppressions

View Suppressions

List all blocked email addresses. See why each was suppressed and when.

get_campaign_stats

Campaign Analytics

Get detailed stats for specific campaigns by tracking ID. Compare performance across sends.

add/remove_suppression

Manage Blocklist

Add or remove emails from your suppression list. Unblock addresses when issues are resolved.

Connect Claude Desktop

Choose your preferred setup method

Zero Installation
1

Open Claude Desktop Settings

Go to Settings → Connectors → Add custom connector

2

Enter the MCP URL

https://api.parsebounce.com/mcp
3

Sign in with ParseBounce

You'll be redirected to sign in. Click Allow to grant access.

✓

Start chatting!

Ask Claude about your email delivery, bounces, and suppressions.

AlternativeLocal Installation

For developers who prefer running the MCP server locally:

1

Get your API key

Go to Profile and create an API key.

2

Add to Claude config

{
  "mcpServers": {
    "parsebounce": {
      "command": "npx",
      "args": ["-y", "@parsebounce/mcp-server"],
      "env": {
        "PARSEBOUNCE_API_KEY": "pb_live_..."
      }
    }
  }
}

Open source and MIT licensed — npm · GitHub

3

Restart Claude Desktop

Restart the app and start asking questions about your email data.

Connect ChatGPT

Requires ChatGPT Plus, Pro, or Team with Developer Mode enabled

Zero Installation
1

Open ChatGPT Settings

Go to chatgpt.com → Settings → Apps

2

Enable Developer Mode

Toggle on Developer Mode to create custom apps

3

Create New App

Click "Create app" and fill in:

  • Name: ParseBounce
  • Description: Email deliverability monitoring
  • MCP Server URL:
https://api.parsebounce.com/mcp

Authentication: Select OAuth (leave Client ID and Client Secret empty)

4

Connect and Authorize

Click "Connect" button, then sign in to ParseBounce and grant access.

5

Select App in Chat

Before asking questions, select ParseBounce app in the chat input area.

✓

Start chatting!

Ask ChatGPT about your email delivery, bounces, and suppressions.

Note: ChatGPT MCP requires a paid subscription (Plus, Pro, or Team) with Developer Mode enabled. Developer Mode can be enabled in ChatGPT settings.

Secure OAuth Authentication

Remote MCP uses OAuth 2.1 with PKCE for secure authentication. Your credentials are never shared with AI clients — only a secure access token that you explicitly authorize. You can revoke access anytime from your profile settings.

Frequently asked questions

What is the ParseBounce MCP server?

It exposes your ParseBounce data — bounces, spam complaints, suppression lists, delivery statistics and campaigns — as tools an AI assistant can call. MCP (Model Context Protocol) is an open standard, so any compatible client can ask questions like “why did our welcome emails bounce yesterday?” and get an answer from your real delivery data instead of a guess.

Do I need to install anything?

Not for Claude Desktop, Claude Code or ChatGPT — they support remote MCP, so you paste the URL https://api.parsebounce.com/mcp, sign in with ParseBounce and approve access. For Cursor, VS Code, Windsurf and other stdio-only clients, add the @parsebounce/mcp-server package to your MCP config with an API key; npx downloads it on first run, so there is nothing to install by hand.

Which AI clients work with it?

Any MCP-compatible client. In practice that means Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code with Copilot, Windsurf, Continue.dev and a growing list of others. Clients with OAuth support connect to the remote server directly; the rest use the npm package.

Which email providers does it cover?

AWS SES, SendGrid, Mailgun, SparkPost, Postmark and Mandrill. ParseBounce normalises webhooks from all of them into one format, so the AI sees a single consistent view of deliverability no matter how many providers you send through.

Can the AI send emails or change my data?

Only if you let it, and only on a paid plan. Alongside the read-only tools there are ones that add or remove suppressions, send transactional email and control campaigns. Every one of them is marked as destructive in the protocol, so your client asks you to confirm before it runs. Free-plan sessions never see those tools at all. You can revoke a connected client at any time from your profile settings.

Is the MCP server free?

Reading is free. On the free plan you can connect a client and run up to 200 tool calls a month — checking addresses, investigating bounces, pulling stats and reputation on your own data. Paid plans lift that cap and add the tools that change data or send email. The npm package itself is open source under the MIT licence, free to inspect, fork or audit before you connect anything.

Ready to talk to your email data?

Read-only MCP is free. Paid plans remove the monthly cap and unlock sending.

Get Started

View pricing