Setup ZeroBounce MCP in Visual Studio Code

Complete setup guide for using ZeroBounce MCP server in VS Code.

Prerequisites

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

1Installation

Install the ZeroBounce MCP server globally:

Terminal
$npm install -g @zerobounce/mcp

2Configuration

a

Install MCP Extension

Open VS Code, press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS), search for "Model Context Protocol" or "MCP" and install the official MCP extension

b

Open Command Palette

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)

c

Add MCP Server

Type "MCP: Add Server" and select it from the list

d

Choose Settings Location

Select whether to add the server for the current workspace or globally for your user

e

Paste Configuration

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

f

Save Configuration

The MCP server should now be available in VS Code

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 Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  2. 2Type and select "MCP: List Available Tools"
  3. 3Look for ZeroBounce tools in the list
  4. 4Try a test command: "How many ZeroBounce credits do I have?"

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

MCP Extension Not Found

  • Search for "Model Context Protocol" in the Extensions marketplace
  • Ensure you're using an up-to-date version of VS Code
  • Check that extensions are not blocked by your organization's policy

Server Not Appearing

  • Verify Node.js is installed: run `node --version` in integrated terminal
  • Check MCP extension is enabled (Extensions → MCP → Enabled)
  • Restart VS Code completely
  • View MCP logs via Command Palette → "MCP: Show Logs"

Invalid API Key

  • Double-check your API key at ZeroBounce Dashboard
  • Ensure no extra spaces or characters in the configuration
  • Verify the API key hasn't expired
  • Try regenerating your API key

Connection Errors

  • Check your internet connection
  • Verify firewall allows api.zerobounce.net
  • Check proxy settings in VS Code (File → Preferences → Settings → Proxy)
  • Disable VPN temporarily to test

Get Your API Key

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

Get API Key