Setup ZeroBounce MCP in Cursor

Complete setup guide for using ZeroBounce MCP server in Cursor.

Prerequisites

  • Node.js installed (verify with node --version)
  • ZeroBounce API key from ZeroBounce Dashboard
  • Cursor installed and ready to configure

1Installation

Install the ZeroBounce MCP server globally:

Terminal
$npm install -g @zerobounce/mcp

2Configuration

a

Open Cursor Settings

Click on the Cursor menu and select "Settings" → "Cursor Settings"

b

Navigate to MCP Tab

Look for the "MCP" section in settings

c

Add New Server

Click "Add new global MCP server" to open the configuration editor

d

Paste Configuration

Copy and paste the configuration JSON, replacing YOUR_API_KEY with your actual ZeroBounce API key

e

Restart Cursor

Close and reopen Cursor for the changes to take effect

Configuration JSON:

mcp-config.json
{
  "mcpServers": {
    "zerobounce": {
      "command": "zerobounce-mcp",
      "args": ["--api-key=YOUR_API_KEY"]
    }
  }
}

Important: Replace YOUR_API_KEY with your actual ZeroBounce API key

3Verifying Installation

  1. 1Open the Composer (⌘/Ctrl + I)
  2. 2Try a test command: "How many ZeroBounce credits do I have?"
  3. 3You should see the server respond with your credit balance

Usage Examples

Try these commands in your AI client:

"Validate the email "test@example.com""
"Check if "user@domain.com" is valid"
"How many credits do I have?"

Troubleshooting

Server Not Appearing

  • Ensure you're using Cursor v1 or greater (check Help → About)
  • Verify Node.js is installed: run `node --version` in terminal
  • Restart Cursor completely (quit and reopen)
  • Check the MCP configuration in Settings → Cursor Settings → MCP

Invalid API Key

  • Verify your API key at ZeroBounce Dashboard
  • Ensure there are no extra spaces in the configuration
  • Check that the API key hasn't expired
  • Try regenerating your API key in the dashboard

Connection Errors

  • Check your internet connection
  • Verify no firewall is blocking api.zerobounce.net
  • Check if a proxy is interfering with connections
  • Try using a different network

Get Your API Key

Sign in to your ZeroBounce account to create or copy your API key for this integration.

Get API Key