# Leadloadz Mcp Server

> B2B lead search and email verification MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-ali1041-leadloadz-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Ali1041](https://agentstack.voostack.com/s/ali1041)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 1.0.4
- **License:** MIT
- **Upstream author:** [Ali1041](https://github.com/Ali1041)
- **Source:** https://github.com/Ali1041/leadloadz-mcp-server

## Install

```sh
agentstack add mcp-ali1041-leadloadz-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @leadloadz/mcp-server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that connects AI assistants to the [Leadloadz](https://www.leadloadz.com) 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:

```bash
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:

```bash
npx -y @leadloadz/mcp-server
```

### Via npm

```bash
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](https://www.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`:

```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:

```json
{
  "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:

```json
{
  "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.

**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

- Website: [leadloadz.com](https://www.leadloadz.com)
- Issues: [GitHub Issues](https://github.com/Ali1041/leadloadz-mcp-server/issues)

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Ali1041](https://github.com/Ali1041)
- **Source:** [Ali1041/leadloadz-mcp-server](https://github.com/Ali1041/leadloadz-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.4** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ali1041-leadloadz-mcp-server
- Seller: https://agentstack.voostack.com/s/ali1041
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.