Skip to main content
ZeroBounce Docs logo
Log InSign Up Free
  • Home
  • Getting started
  • Products
  • API
  • Integrations
  • FAQ
  • About ZeroBounce
Browse documentation
ZeroBounce Docs logo
  • Getting started
  • Products
  • API
  • Integrations
  • FAQ
  • About ZeroBounce

Type at least 2 characters to search the docs.

↑↓ Navigate↵ OpenEsc Close

Docs Assistant

Answers written from the ZeroBounce documentation

Hi! I'm your ZeroBounce Docs Assistant. How can I help you with our APIs or integrations today?

Try Asking

Loading suggestions...

AI-generated from our docs. Check important details against the linked pages.

Integrations

  • ActiveCampaign Integration
  • Adobe Journey Integration
  • Adobe Marketo Integration
  • Amazon S3 Integration
  • Amazon S3 Bulk API
  • BigCommerce Integration
  • AWeber Integration
  • Clay.com Integration
  • Drip Integration
  • Customer.io Integration
  • Constant Contact Integration
  • Contact Form 7 Integration
  • Email Validator Browser Extension
  • Ghost Integration
  • CloudFlare Worker Integration
  • ChatGPT Integration
  • Claude
  • Google Sheets Integration
  • Gravity Forms Integration
  • Infinity Integration
  • Integrations Contacts Monitoring, Scheduling and Sharing
  • iPost Integration
  • HubSpot Integration
  • Iterable Integration
  • HubSpot Forms Integration
  • HubSpot Warmup Integration
  • JS Widget
  • Klaviyo Integration
  • Klaviyo Forms Integration
  • LinkedIn Integration
  • Mailchimp Integration
  • Microsoft Dynamics Integration
  • MailerLite Integration
  • monday.com Integration
  • Moosend Integration
  • Outreach Integration
  • PipeDrive Integration
  • Salesforce Integration v1.39
  • SFTP/FTP Integration
  • SFTP/FTP Bulk API
  • Unbounce Integration
  • Wix Integration
  • WordPress/WooCommerce Plugins
  • Zapier Integration
  • Zendesk Sell Integration
  • ZeroBounce MCP Server
    • Setup
      • Cursor
      • VS Code
      • Claude
      • Other Clients
    • Tools
  • Zoho Integration
  1. Home
  2. API Integrations
  3. Zerobounce MCP Server
  4. Setup
  5. Cursor

Setup ZeroBounce MCP in Cursor

Complete setup guide for using ZeroBounce MCP server in Cursor.

Prerequisites

  • Green checkmark iconNode.js installed (verify with node --version)
  • Green checkmark iconZeroBounce API key from ZeroBounce Dashboard
  • Green checkmark iconCursor installed and ready to configure
1

Installation

Install the ZeroBounce MCP server globally:

npm install -g @zerobounce/mcp
2

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:

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.

3

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

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

Info shield icon

Server Not Appearing

  • Check iconEnsure you're using Cursor v1 or greater (check Help → About)
  • Check iconVerify Node.js is installed: run node --version in terminal
  • Check iconRestart Cursor completely (quit and reopen)
  • Check iconCheck the MCP configuration in Settings → Cursor Settings → MCP
Info shield icon

Invalid API Key

  • Check iconVerify your API key at ZeroBounce Dashboard
  • Check iconEnsure there are no extra spaces in the configuration
  • Check iconCheck that the API key hasn't expired
  • Check iconTry regenerating your API key in the dashboard
Info shield icon

Connection Errors

  • Check iconCheck your internet connection
  • Check iconVerify no firewall is blocking api.zerobounce.net
  • Check iconCheck if a proxy is interfering with connections
  • Check iconTry 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

Was this page helpful?

PreviousZeroBounce MCP ServerNextVS Code
Interested in our partner programs?
Partner program

Interested in our partner programs?