@leadloadz/mcp-server

A Model Context Protocol (MCP) server that connects AI assistants to the Leadloadz B2B lead generation platform.

Features

Search Leads — Find verified B2B leads using natural language queries
Verify Email — Real-time email verification with deliverability scoring
Get Stats — Check your usage and remaining quotas
Interactive Setup — Built-in wizard to get your API key
Anonymous Telemetry — Helps us improve the product (no PII, opt-out via LEADLOADZ_DISABLE_TELEMETRY=1)

Quick Start

Don't have an API key yet?

Run the setup wizard:

npx @leadloadz/mcp-server --setup

This will guide you through creating an account and getting your API key.

Already have an API key?

Add it to your MCP client configuration (see below) and start using Leadloadz directly.

Installation

Via npx (recommended)

No installation required. AI clients can run the server directly:

npx -y @leadloadz/mcp-server

Via npm

npm install -g @leadloadz/mcp-server
leadloadz-mcp

Configuration

You need a Leadloadz API key to use this server.

Sign up at leadloadz.com
Go to Dashboard → API Tokens
Generate a new token
Copy the token value

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "leadloadz": {
      "command": "npx",
      "args": ["-y", "@leadloadz/mcp-server"],
      "env": {
        "LEADLOADZ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code)

Add to your Cline MCP settings:

{
  "mcpServers": {
    "leadloadz": {
      "command": "npx",
      "args": ["-y", "@leadloadz/mcp-server"],
      "env": {
        "LEADLOADZ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other Clients

Any MCP client that supports stdio transport can use:

{
  "command": "npx",
  "args": ["-y", "@leadloadz/mcp-server"],
  "env": {
    "LEADLOADZ_API_KEY": "your-api-key-here"
  }
}

Environment Variables

Variable	Required	Default	Description
`LEADLOADZ_API_KEY`	Yes	—	Your Leadloadz API token
`LEADLOADZ_API_BASE`	No	`https://leadloadz.com/api/mcp`	API base URL (do not use `www` — redirects strip auth headers)
`LEADLOADZ_TIMEOUT_MS`	No	`30000`	Request timeout in milliseconds
`LEADLOADZ_DISABLE_TELEMETRY`	No	`0`	Set to `1` to disable anonymous usage telemetry

Tools

search_leads

Search indexed B2B contacts by role, company, location, or technology.

Parameters:

query (string, required): Specific natural-language search query
limit (number, optional): Max results. Default: 10, Cap: 50

Returns: Verified leads with deliverability scores

verify_email

Check email deliverability in real-time.