Setup ZeroBounce MCP in Cursor

Prerequisites

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

Install the ZeroBounce MCP server globally:

npm install -g @zerobounce/mcpCopy

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:

mcp-config.jsonCopy

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

Important: Replace YOUR_API_KEY with your actual ZeroBounce API key.

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

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