← Back to Home

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

Installation

Install the ZeroBounce MCP server globally:

npm install git+https://github.com/zerobounce/zerobounce-mcp.git

Configuration

1

Open Cursor Settings

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

2

Navigate to MCP Tab

Look for the "MCP" section in settings

3

Add New Server

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

4

Paste Configuration

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

5

Restart Cursor

Close and reopen Cursor for the changes to take effect

Configuration JSON:

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

⚠️ Important: Replace YOUR_API_KEY with your actual ZeroBounce API key

Verifying Installation

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

Usage Examples

Validate the email "[email protected]"
Check if "[email protected]" is valid
How many credits do I have?

Troubleshooting

Problem: 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

Problem: 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

Problem: 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

Your ZeroBounce API key is available in the ZeroBounce dashboard:

  1. Sign in to your ZeroBounce account
  2. Navigate to the API / Developer or Integrations section
  3. Create or copy an API key for this integration
  4. Use different keys for development, staging, and production when possible
Get API Key →