io.github.Ali1041/leadloadz
B2B lead search and email verification MCP server
What can you do with io.github.Ali1041/leadloadz?
- 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)
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@leadloadz/mcp-serverclaude mcp add leadloadz -e 'LEADLOADZ_API_KEY=<your leadloadz_api_key>' -e 'LEADLOADZ_API_BASE=<LEADLOADZ_API_BASE>' -- npx -y @leadloadz/mcp-server@1.1.3
{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": [
"-y",
"@leadloadz/mcp-server@1.1.3"
],
"env": {
"LEADLOADZ_API_KEY": "<your leadloadz_api_key>",
"LEADLOADZ_API_BASE": "<LEADLOADZ_API_BASE>"
}
}
}
}
Environment variables
LEADLOADZ_API_KEYrequired secret Your Leadloadz API keyLEADLOADZ_API_BASEAPI base URL (default: https://leadloadz.com/api/mcp). Do not use www — redirects strip auth headers.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
@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 querylimit(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
- Issues: GitHub Issues
License
MIT
Frequently asked questions
What is io.github.Ali1041/leadloadz?
B2B lead search and email verification MCP server
How do I install io.github.Ali1041/leadloadz?
It runs on your machine. In Claude Code: claude mcp add leadloadz -e 'LEADLOADZ_API_KEY=<your leadloadz_api_key>' -e 'LEADLOADZ_API_BASE=<LEADLOADZ_API_BASE>' -- npx -y @leadloadz/mcp-server@1.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.Ali1041/leadloadz need an API key?
Yes. It expects LEADLOADZ_API_KEY, which you set in its configuration.
Is io.github.Ali1041/leadloadz open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.Ali1041/leadloadz?
It is published by Ali1041. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.