Skip to main content
Glama
Ali1041

Leadloadz

by Ali1041

@leadloadz/mcp-server

leadloadz-mcp-server MCP server leadloadz-mcp-server MCP server Ein Model Context Protocol (MCP)-Server, der KI-Assistenten mit der B2B-Lead-Generierungsplattform Leadloadz verbindet.

Funktionen

  • Leads suchen — Finden Sie verifizierte B2B-Leads mithilfe von natürlichsprachlichen Abfragen

  • E-Mail verifizieren — E-Mail-Verifizierung in Echtzeit mit Zustellbarkeitsbewertung

  • Statistiken abrufen — Überprüfen Sie Ihre Nutzung und verbleibenden Kontingente

Related MCP server: LeadClaw

Installation

Via npx (empfohlen)

Keine Installation erforderlich. KI-Clients können den Server direkt ausführen:

npx -y @leadloadz/mcp-server

Via npm

npm install -g @leadloadz/mcp-server
leadloadz-mcp

Konfiguration

Sie benötigen einen Leadloadz-API-Schlüssel, um diesen Server zu verwenden.

  1. Registrieren Sie sich unter leadloadz.com

  2. Gehen Sie zu Dashboard → API Tokens

  3. Generieren Sie ein neues Token

  4. Kopieren Sie den Token-Wert

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}
}
}

Cline (VS Code)

Fügen Sie dies zu Ihren Cline-MCP-Einstellungen hinzu:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}
}
}

Andere Clients

Jeder MCP-Client, der den stdio-Transport unterstützt, kann Folgendes verwenden:

{
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}

Umgebungsvariablen

Variable

Erforderlich

Standard

Beschreibung

LEADLOADZ_API_KEY

Ja

—

Ihr Leadloadz-API-Token

LEADLOADZ_API_BASE

Nein

https://www.leadloadz.com/api/mcp

API-Basis-URL

LEADLOADZ_TIMEOUT_MS

Nein

30000

Anfrage-Timeout in Millisekunden

Entwicklung


# Abhängigkeiten installieren

npm install

# Build

npm run build

# Typ-Prüfung

npm run typecheck

# Lokal testen

node dist/index.js

Änderungen veröffentlichen (WICHTIG — BITTE LESEN)

Wann veröffentlicht werden sollte

Veröffentlichen Sie eine neue Version, wenn Sie:

  • Neue Tools hinzufügen oder bestehende Tool-Schemata ändern

  • Das Verhalten von API-Endpunkten ändern, das sich auf MCP-Antworten auswirkt

  • Fehler beheben im MCP-Server-Code

  • Abhängigkeiten aktualisieren (insbesondere @modelcontextprotocol/sdk)

  • Umgebungsvariablen oder Konfigurationsoptionen ändern

Veröffentlichen Sie NICHT bei Änderungen an:

  • Der Leadloadz-Haupt-Web-App (dies ist eine separate Codebasis)

  • API-Routen in der Next.js-App (der MCP-Server fungiert als Proxy für diese)

  • Datenbankschemata (wird von der Haupt-App verwaltet)

  • UI-Komponenten oder Marketing-Seiten

Wie man veröffentlicht

Schritt 1: Code-Änderungen vornehmen

Bearbeiten Sie die Dateien in src/ nach Bedarf. Lokal testen:

npm run build
npm test

Schritt 2: Version aktualisieren

npm version patch   # für Fehlerbehebungen
npm version minor   # für neue Funktionen
npm version major   # für Breaking Changes

Schritt 3: server.json aktualisieren

Wenn Sie die Version geändert haben, aktualisieren Sie server.json entsprechend:

{
"version": "1.0.X",
"packages": [
{
"version": "1.0.X"
}
]
}

Schritt 4: Committen und auf GitHub pushen

git add .
git commit -m "Beschreiben Sie Ihre Änderungen"
git push origin master

Schritt 5: Auf npm veröffentlichen

echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" > .npmrc
npm publish --access public
rm -f .npmrc

Hinweis: Das npm-Token beginnt mit npm_. Bewahren Sie es sicher auf und committen Sie es niemals.

Schritt 6: Erneute Veröffentlichung im Anthropic MCP Registry

Das Anthropic MCP Registry muss aktualisiert werden, wenn Sie eine neue npm-Version veröffentlichen:


# Login (Token läuft ab, daher müssen Sie dies möglicherweise jedes Mal tun)

./mcp-publisher login github

# Folgen Sie dem Geräte-Authentifizierungsablauf:

# 1. Gehen Sie zu https://github.com/login/device

# 2. Geben Sie den angezeigten Code ein

# 3. Autorisieren Sie die Anwendung

# Veröffentlichen

./mcp-publisher publish

Kritisch: Der mcpName in package.json MUSS exakt mit dem name in server.json übereinstimmen (Groß-/Kleinschreibung beachten). Derzeit verwenden beide io.github.Ali1041/leadloadz.

Wo es veröffentlicht wird

Plattform

URL

Zweck

npm

https://www.npmjs.com/package/@leadloadz/mcp-server

Paketverteilung

GitHub

https://github.com/Ali1041/leadloadz-mcp-server

Quellcode

Anthropic MCP Registry

https://registry.modelcontextprotocol.io

Offizielles Anthropic-Verzeichnis

Glama.ai

https://glama.ai/mcp/servers

Community-Verzeichnis

PulseMCP

https://www.pulsemcp.com

Community-Verzeichnis

Smithery.ai

https://smithery.ai

Community-Verzeichnis

MCP.Directory

https://mcp.directory

Community-Verzeichnis

Fehlerbehebung bei der Veröffentlichung

Fehler "Token expired":

  • Führen Sie ./mcp-publisher login github erneut aus

Fehler "You do not have permission":

  • Stellen Sie sicher, dass der Name in server.json exakt mit Ihrem GitHub-Benutzernamen übereinstimmt: io.github.Ali1041/leadloadz

  • Stellen Sie sicher, dass der mcpName in package.json exakt übereinstimmt

Fehler "Validation failed":

  • Die Beschreibung muss ≤ 100 Zeichen lang sein

  • Alle erforderlichen Felder in server.json müssen vorhanden sein

  • Das npm-Paket muss bereits mit der passenden Version veröffentlicht worden sein

Sicherheit

  • Ihr API-Schlüssel wird niemals protokolliert oder in Fehlermeldungen angezeigt

  • Alle Fehler werden bereinigt, um Informationslecks zu verhindern

  • Der Server kommuniziert direkt über HTTPS mit den Leadloadz-APIs

  • Ratenbegrenzungen werden durch die Leadloadz-API durchgesetzt

Support

Lizenz

MIT

Available Tools

3 tools
get_user_statsA

Read current usage counters: searches performed, emails verified, and remaining quota. Read-only. Requires API key. Rate limit: 30/min per user. Use before batch operations to check available allowance.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses read-only nature, API key requirement, and rate limit (30/min per user). No annotations exist, so the description carries full burden; it adequately covers behavioral traits for a safe read operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three concise sentences front-load the purpose and add necessary behavioral info without redundancy. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Provides enough context for a parameterless tool: what it reads, when to use it, and constraints. Lacks details on return format, but acceptable for simple stats retrieval.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters in input schema, so baseline score is 4. Description does not need to add parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it reads usage counters (searches, emails, quota). It distinguishes itself from siblings 'search_leads' and 'verify_email' by specifying a different resource and action.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly advises to use before batch operations to check allowance. While it doesn't discuss when not to use or alternatives, the provided context is sufficient for a simple read tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_leadsA

Search indexed B2B contacts by role, company, location, or technology. Read-only; returns verified leads with deliverability scores. Requires API key. Rate limit: 30/min per user. Use verify_email after discovery to confirm deliverability before outreach.

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

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully covers behavioral traits: read-only, returns verified leads with deliverability scores, requires API key, and rate limit of 30/min per user.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with purpose, no wasted words. Each sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 2-param search tool with no output schema, the description adequately explains input (search criteria), behavior (read-only, deliverability scores), constraints (rate limit, API key), and follow-up action (verify_email). Complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and schema descriptions already detail both parameters. The tool description adds no new parameter information beyond what's in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it searches indexed B2B contacts by role, company, location, or technology. Distinct from siblings get_user_stats and verify_email.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides guidance on when to use (searching leads) and recommends verify_email for further action. Lacks explicit when-not-to-use but implies context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

verify_emailA

Check email deliverability in real-time: MX records, SMTP, disposable/role detection. Read-only. Requires API key. Rate limit: 30/min per user. Use after search_leads or before sending campaigns. Returns deliverability score and risk assessment.

ParametersJSON Schema
NameRequiredDescriptionDefault
emailYesSingle email address to verify. Must be a valid RFC-like address format.

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses read-only nature, API key requirement, and rate limit (30/min per user) without any annotations. Also describes return value (deliverability score and risk assessment).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Concise, packing core purpose, behavior, guidelines, and return info into a few sentences. No wasted words, well front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers all essential aspects for a simple tool: purpose, behavior, auth, rate limit, usage context, and return summary. No gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema already provides 100% coverage with description for 'email' parameter. Description does not add additional semantic detail beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states 'Check email deliverability in real-time' with specific checks (MX records, SMTP, disposable/role detection). Differentiates from siblings like get_user_stats and search_leads by focusing on email verification.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says 'Use after search_leads or before sending campaigns', providing clear context. Lacks explicit exclusions or alternatives, but sufficiently guides usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv1.0.6
    • Addedget_user_stats
    • Addedsearch_leads
    • Addedverify_email
  2. 3 tool updatesv1.0.5
    • Removedget_user_stats
    • Removedsearch_leads
    • Removedverify_email
  3. 3 tool updatesv0.1.0
    • First observedget_user_stats
    • First observedsearch_leads
    • First observedverify_email

TDQS

A4.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool serves a distinct purpose: usage stats, lead searching, and email verification. No functional overlap.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern (get_user_stats, search_leads, verify_email).

Tool Count5/5

Three tools is well-scoped for a lead generation and verification service, covering essential operations without redundancy.

Completeness5/5

The set covers the full workflow: check quota, search leads, and verify email deliverability. No missing critical operations given the read-only nature.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    B2B lead generation MCP server with 20+ lead generation tools - Apollo scraping, Google Maps, email finder, email validator, mobile finder, skip trace, ecommerce store data, and more.
    25
    30 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that enables AI agents to discover and qualify B2B leads from Leadbay's knowledge base, with tools for lead research, enrichment, and outreach logging.
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Lead generation MCP server for AI agents. Find emails, verify contacts, enrich profiles, and search prospects using Hunter.io, Apollo.io, and Abstract API.
    8
    13 npm
    MIT