Back to Directory/Developer Tools

io.github.Ali1041/leadloadz

B2B lead search and email verification MCP server

Developer ToolsTypeScriptv1.1.3

@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.

  1. Sign up at leadloadz.com
  2. Go to Dashboard → API Tokens
  3. Generate a new token
  4. 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

VariableRequiredDefaultDescription
LEADLOADZ_API_KEYYes—Your Leadloadz API token
LEADLOADZ_API_BASENohttps://leadloadz.com/api/mcpAPI base URL (do not use www — redirects strip auth headers)
LEADLOADZ_TIMEOUT_MSNo30000Request timeout in milliseconds
LEADLOADZ_DISABLE_TELEMETRYNo0Set 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.

Parameters:

  • email (string, required): Email address to verify

Returns: Deliverability score and risk assessment

get_user_stats

Read current usage counters.

Returns: Searches performed, emails verified, and remaining quota

Security

  • Your API key is never logged or exposed in error messages
  • All errors are sanitized to prevent information leakage
  • Communication with Leadloadz APIs uses HTTPS

Support

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @leadloadz/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-ali1041-leadloadz": {
      "command": "npx",
      "args": [
        "-y",
        "@leadloadz/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@leadloadz/mcp-servernpm

Compatible MCP Clients

io.github.Ali1041/leadloadz works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More