io.github.Ali1041/leadloadz
B2B lead search and email verification MCP server
Open source Open in the app JSON README (API)
About
B2B lead search and email verification MCP server
Details
- Kind
- MCP servers
- Topic
- Communication
- Publisher
- ali1041
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.3
- Open pull requests
- 1
- Last push
- 2026-05-29T02:01:54Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:41
- Updated
- 2026-08-29 03:01:41
- Origin id
io.github.Ali1041/leadloadz
README
# @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