mcpField
L
leadloadz

leadloadz

Local
github.com/Ali1041Business & Marketing0Updated 22w ago
Repository

About leadloadz

leadloadz is an MCP server connecting AI assistants to the Leadloadz B2B lead platform. It is for finding business contacts and checking email deliverability, with usage statistics and an API-key setup wizard also included.

Key features

  1. 01Search contacts by role, company, location, or technology
  2. 02Verify emails in real time with scores
  3. 03Check usage and remaining quota
  4. 04Interactive API key setup wizard

Use cases

  1. 01Find B2B contacts by target role and location
  2. 02Check email deliverability before outreach
  3. 03Review API usage and remaining quota

MCP support

The server connects to the Leadloadz API over stdio and exposes lead search, email verification, and usage statistics tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ali1041-leadloadz": {
      "command": "npx",
      "args": [
        "-y",
        "@leadloadz/mcp-server"
      ],
      "env": {
        "LEADLOADZ_API_KEY": "<LEADLOADZ_API_KEY>",
        "LEADLOADZ_API_BASE": "<LEADLOADZ_API_BASE>"
      }
    }
  }
}
Run commandnpx -y @leadloadz/mcp-server
Environment variables to set
LEADLOADZ_API_KEYSecretYour Leadloadz API key
LEADLOADZ_API_BASEAPI base URL (default: https://leadloadz.com/api/mcp). Do not use www — redirects strip auth headers.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@leadloadz/mcp-server1.1.3

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitnumberNoMaximum results to return. Default: 10. Cap: 50. Higher values consume more quota.
querystringYesSpecific natural-language search query. Narrow criteria yield better precision (e.g., 'CTOs at Series A B2B SaaS in London')

Details

From the project README

@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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.