MCP Server

Das Model Context Protocol (MCP) ist ein offenes Protokoll von Anthropic, das es KI-Modellen ermöglicht, sicher mit externen Tools und Datenquellen zu interagieren. BillionVerify bietet Enterprise-Grade E-Mail-Verifizierungsfunktionen für KI-Agenten über HTTP Streamable Transport, was die Integration unglaublich einfach macht.

Warum KI-Agenten E-Mail-Verifizierung benötigen

Moderne KI-Agenten-Anwendungsfälle umfassen:

• Claude Code muss E-Mail-Adressen bei der Verarbeitung von Benutzerdaten verifizieren
• OpenCode benötigt E-Mail-Validierung in automatisierten Workflows
• Gemini CLI-Agenten brauchen Qualitätssicherung bei der Verarbeitung von Registrierungsdaten
• Codex-generierter Code benötigt integrierte E-Mail-Verifizierungslogik
• Benutzerdefinierte KI-Agenten müssen die Authentizität von Kontakten bei der Interaktion mit Menschen bestätigen

BillionVerify MCP ermöglicht es jedem KI-Agenten, Enterprise-Grade E-Mail-Verifizierungsdienste direkt über den HTTP Streamable Transport-Standard aufzurufen - keine komplexe Konfiguration erforderlich.

Kernfunktionen

1. Einzelne E-Mail-Echtzeit-Verifizierung

• E-Mail-Format, Domain und MX-Records verifizieren
• Optionale SMTP-Verbindungsprüfung
• Wegwerf-E-Mail-Erkennung
• Unternehmens- vs. kostenlose E-Mail-Identifikation
• Rollenbasierte E-Mail-Erkennung (support@, noreply@, etc.)
• Durchschnittliche Antwortzeit < 2 Sekunden

2. Stapel-E-Mail-Verifizierung

• Bis zu 50 E-Mails auf einmal verifizieren
• Parallele Verarbeitung für Effizienz
• Detaillierte Ergebnisse und Statistiken

3. Intelligentes Caching-System

• Gültige E-Mails werden 7 Tage zwischengespeichert
• Ungültige E-Mails werden 7 Tage zwischengespeichert
• Unbekannter Status wird 10 Minuten zwischengespeichert
• Reduziert unnötige wiederholte Verifizierungen

4. Präzise Credit-Abrechnung

• Gültige E-Mail: 1 Credit
• Ungültige E-Mail: 0 Credits (verhindert Verschwendung)
• Unbekannter Status: 0 Credits (automatischer Wiederversuch)
• Echtzeit-Kontostandabfragen

Unterstützte KI-Clients

Schnelleinrichtung (HTTP Transport - Empfohlen)

Der einfachste Weg zur Integration - keine npm-Pakete zu installieren!

Schritt 1: API-Schlüssel erhalten

Besuchen Sie das BillionVerify Dashboard, um Ihren API-Schlüssel zu erstellen.

Schritt 2: Claude Desktop konfigurieren

Bearbeiten Sie die Konfigurationsdatei:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"]
    }
  }
}

Ersetzen Sie IHR_API_SCHLÜSSEL durch Ihren tatsächlichen API-Schlüssel und starten Sie dann Claude Desktop neu.

Das war's! Kein npm install, keine Abhängigkeiten. curl ist auf allen Systemen vorinstalliert. Claude hat jetzt E-Mail-Verifizierungsfähigkeiten.

Schritt 3: Mit der Verifizierung beginnen

In Ihrer Konversation fragen Sie einfach:

Bitte verifiziere diese E-Mail: user@example.com

Claude wird automatisch BillionVerify aufrufen und detaillierte Ergebnisse zurückgeben.

Claude Code Einrichtung

Für Claude Code CLI fügen Sie den MCP-Server hinzu:

claude mcp add billionverify -- curl --stdio "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"

Oder fügen Sie zu Ihrer ~/.claude.json hinzu:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"]
    }
  }
}

OpenCode Einrichtung

Für OpenCode konfigurieren Sie in Ihrer ~/.opencode/config.json:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"]
    }
  }
}

Gemini CLI Einrichtung

Für Gemini CLI fügen Sie zu Ihrer Konfiguration hinzu:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"]
    }
  }
}

Cursor Einrichtung

Gehen Sie in Cursor zu Settings > MCP und fügen Sie hinzu:

{
  "billionverify": {
    "command": "curl",
    "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=IHR_API_SCHLÜSSEL"]
  }
}

NPX-Methode (Alternative)

Wenn Sie den npm-Paket-Ansatz bevorzugen:

{
  "mcpServers": {
    "billionverify": {
      "command": "npx",
      "args": ["-y", "@billionverify/mcp-server"],
      "env": {
        "BV_API_KEY": "ihr-api-schlüssel-hier"
      }
    }
  }
}

Verfügbare Tools

verify_single_email

Eine einzelne E-Mail-Adresse mit umfassender Validierung verifizieren.

Parameter:

Rückgabe:

{
  "email": "user@example.com",
  "status": "valid",
  "score": 1,
  "is_deliverable": true,
  "is_disposable": false,
  "is_catchall": false,
  "is_role": false,
  "is_free": true,
  "domain": "example.com",
  "mx_records": ["has_mx_records"],
  "smtp_check": true,
  "response_time": 2,
  "credits_used": 1
}

Beispielnutzung in Claude:

"Prüfe, ob test@example.com eine gültige E-Mail ist"

verify_batch_emails

Mehrere E-Mail-Adressen auf einmal verifizieren (max 50).

Parameter:

Rückgabe:

{
  "total_emails": 2,
  "valid_emails": 2,
  "invalid_emails": 0,
  "results": [...],
  "credits_used": 2,
  "process_time": 4
}

Beispielnutzung in Claude:

"Verifiziere diese E-Mails: user1@example.com, user2@test.com, info@company.com"

get_account_balance

Kontostand und Nutzungsstatistiken prüfen.

Parameter: Keine

Rückgabe:

{
  "account_id": "acc_xxx",
  "credits_balance": 842740,
  "credits_consumed": 157260,
  "credits_added": 1000000,
  "last_updated": "2026-02-05T04:51:35Z"
}

Beispielnutzung in Claude:

"Wie viele Verifizierungs-Credits habe ich noch übrig?"

health_check

MCP-Server-Gesundheitsstatus prüfen.

Parameter: Keine

Rückgabe:

{
  "status": "healthy",
  "version": "2.1.0",
  "service": "billionverify-mcp",
  "mode": "api-proxy"
}

get_task_status

Fortschritt der Datei-Verifizierungsaufgabe abfragen.

Parameter:

Rückgabe:

{
  "job_id": "job-uuid-xxxxx",
  "status": "completed",
  "progress": 100,
  "total_emails": 1000,
  "processed_emails": 1000,
  "valid_count": 850,
  "invalid_count": 100
}

Beispielnutzung in Claude:

"Was ist der Status meiner Datei-Verifizierungsaufgabe job-123?"

get_download_url

Download-Link für Verifizierungsergebnisse mit optionalen Statusfiltern abrufen.

Parameter:

Beispielnutzung in Claude:

"Hole den Download-Link nur für gültige E-Mails von job-123"

create_webhook

Einen Webhook erstellen, um Benachrichtigungen über den Abschluss der Verifizierung zu erhalten.

Parameter:

Rückgabe:

{
  "id": "webhook-uuid",
  "url": "https://ihr-server.com/webhook",
  "events": ["file.completed"],
  "secret": "hmac-geheimnis-für-signatur",
  "is_active": true
}

Hinweis: Das secret wird nur einmal bei der Erstellung zurückgegeben. Speichern Sie es für die Signaturverifizierung.

Beispielnutzung in Claude:

"Erstelle einen Webhook, um mich zu benachrichtigen, wenn die Datei-Verifizierung abgeschlossen ist"

list_webhooks

Alle Webhooks für das aktuelle Konto auflisten.

Parameter: Keine

Rückgabe:

{
  "total": 1,
  "webhooks": [
    {
      "id": "webhook-uuid",
      "url": "https://ihr-server.com/webhook",
      "events": ["file.completed"],
      "is_active": true
    }
  ]
}

Beispielnutzung in Claude:

"Zeige mir alle meine konfigurierten Webhooks"

delete_webhook

Einen bestimmten Webhook löschen.

Parameter:

Beispielnutzung in Claude:

"Lösche den Webhook mit der ID webhook-123"

Nutzungsbeispiele

Basis-Verifizierung

Benutzer:

Verifiziere john@google.com

Claude:

Ich verifiziere diese E-Mail-Adresse für Sie.

E-Mail-Verifizierungsergebnis

Feld	Wert
E-Mail	john@google.com
Status	Gültig
Zustellbar	Ja
Wegwerf	Nein
Score	0,95

Diese E-Mail scheint gültig und zustellbar zu sein.

Mehrere E-Mails verifizieren

Benutzer:

Prüfe diese E-Mails: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

Ich verifiziere alle drei E-Mail-Adressen.

E-Mail	Status	Hinweise
john@google.com	Gültig	Zustellbar, Unternehmens-E-Mail
test@mailinator.com	Ungültig	Wegwerf-E-Mail, Ablehnung empfohlen
support@microsoft.com	Gültig	Rollenbasierte Adresse, möglicherweise geteilt

Empfehlungen:

• john@google.com - Sicher zu verwenden
• test@mailinator.com - Temporäre E-Mail, nicht empfohlen
• support@microsoft.com - Gültig, aber wahrscheinlich ein Team-Postfach

Entwickler-Workflow

Benutzer (in Claude Code):

Verifiziere die Test-E-Mails in meiner .env.example-Datei

Claude:

Ich lese die Datei und verifiziere alle gefundenen E-Mail-Adressen.

3 E-Mail-Adressen in .env.example gefunden:

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

Verifizierungsergebnisse:

E-Mail	Status
user@example.com	Unbekannt (Beispieldomain)
admin@company.com	Gültig
help@temp-mail.org	Ungültig (Wegwerf)

Erwägen Sie, echte E-Mail-Adressen für Tests zu verwenden.

Ausgabeformat

Der MCP-Server gibt gut formatierte Ergebnisse zurück:

## E-Mail-Verifizierungsergebnis

**E-Mail:** test@example.com
**Status:** GÜLTIG
**Konfidenzwert:** 95,0%

### Details
| Prüfung | Ergebnis |
|-------|--------|
| Zustellbar | Ja |
| Gültiges Format | Ja |
| Gültige Domain | Ja |
| Gültiges MX | Ja |
| Wegwerf | Nein |
| Rollenadresse | Nein |
| Catch-all | Nein |
| Kostenloser Anbieter | Nein |

**Verwendete Credits:** 1

Best Practices

1. API-Schlüssel sicher speichern

Hardcodieren Sie niemals Ihren API-Schlüssel. Verwenden Sie Umgebungsvariablen:

{
  "env": {
    "BV_API_KEY": "${BV_API_KEY}"
  }
}

2. Natürliche Sprache verwenden

Der MCP-Server versteht verschiedene Formulierungen:

• "Verifiziere user@example.com"
• "Ist test@company.com eine gültige E-Mail?"
• "Prüfe, ob diese E-Mail zustellbar ist: john@test.com"
• "Kannst du diese E-Mail-Adressen für mich validieren?"

3. Wenn möglich stapeln

Für mehrere E-Mails bitten Sie Claude, sie zusammen zu verifizieren, um effizienter zu sein:

"Verifiziere alle diese E-Mails auf einmal: email1@test.com, email2@test.com, email3@test.com"

Fehlerbehebung

MCP-Server nicht gefunden

Wenn Claude sagt, dass es das BillionVerify-Tool nicht finden kann:

1. Überprüfen Sie den Pfad Ihrer Konfigurationsdatei
2. Stellen Sie sicher, dass das JSON gültig ist
3. Starten Sie Claude Desktop vollständig neu
4. Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist

Rate Limit-Fehler

Wenn Sie Rate Limit-Fehler sehen:

1. Überprüfen Sie Ihre verbleibenden Credits mit "Wie viele Credits habe ich?"
2. Warten Sie einen Moment und versuchen Sie es erneut
3. Erwägen Sie ein Upgrade Ihres Plans für höhere Limits

Verbindungsprobleme

Wenn die Verifizierung fehlschlägt:

1. Überprüfen Sie Ihre Internetverbindung
2. Überprüfen Sie, ob Ihr API-Schlüssel gültig ist
3. Versuchen Sie zuerst eine einfache Verifizierung

FAQ

Ist mein API-Schlüssel sicher?

Ja. Der API-Schlüssel wird in Ihrer lokalen Konfigurationsdatei gespeichert und nur vom MCP-Server verwendet, der auf Ihrem Computer läuft. Er wird niemals an Dritte gesendet.

Welche KI-Clients unterstützen MCP?

Jeder MCP-kompatible Client funktioniert, einschließlich Claude Desktop, Claude Code, Cursor, Zed, Cline und Continue.

Was passiert bei Offline-Betrieb?

Wenn die BillionVerify-API nicht erreichbar ist, gibt das Tool eine Fehlermeldung zurück. Dies beeinträchtigt nicht die anderen Fähigkeiten von Claude.

Wie funktionieren Credits?

Jede E-Mail-Verifizierung verbraucht 1 Credit. Stapelverifizierungen verbrauchen 1 Credit pro E-Mail. Überprüfen Sie Ihren Kontostand mit dem check_credits-Tool.

Nächste Schritte