Referenz

EmailCheckPro MCP-Referenz

Das Model Context Protocol ermöglicht es KI-Anwendungen, während einer Unterhaltung externe Tools aufzurufen. Bitten Sie Ihren Assistenten, eine E-Mail-Adresse zu prüfen oder einen Stapel auszuwerten, ohne eine eigene API-Integration zu schreiben.

MCP ist ein Protokolladapter. Es nutzt dieselben Produkte, dasselbe Guthaben, dieselbe Abrechnung, dieselben Parallelitätslimits, Zeitlimits und Ergebnissemantik wie die REST API.

Produkte, Preise und Limits finden Sie in der API-Referenz

Authentifizierung

Verwenden Sie genau denselben API-Schlüssel wie für die REST API und tragen Sie ihn in der Konfiguration Ihres MCP-Clients als Bearer-Token ein.

Authorization-Header

Authorization: Bearer YOUR_API_KEY

Halten Sie Ihren API-Schlüssel privatTragen Sie den Schlüssel nur in die Konfiguration Ihres eigenen, vertrauenswürdigen Clients ein. Legen Sie ihn niemals in Browsercode oder öffentlichen Prompts offen.

Server-URL

Richten Sie Ihren Client auf den offiziellen Streamable-HTTP-Endpunkt aus. Ein lokaler MCP-Prozess ist nicht erforderlich.

Eintrag	Wert
MCP-Endpunkt	https://emailcheckpro.com/mcp
Streamable HTTP	Anfragen nutzen JSON-RPC über Streamable HTTP und dieselbe API-Schlüssel-Middleware wie REST.

Client verbinden

Wählen Sie das Konfigurationsformat, das Ihr Client unterstützt. Ersetzen Sie den Platzhalter durch Ihren API-Schlüssel.

claude mcp add --transport http emailcheckpro https://emailcheckpro.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Fügen Sie den Remote-Server über Ihr Terminal hinzu.

{
  "mcpServers": {
    "emailcheckpro": {
      "url": "https://emailcheckpro.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Fügen Sie diesen Servereintrag der MCP-Konfiguration des Clients hinzu.

URL: https://emailcheckpro.com/mcp
Authorization: Bearer YOUR_API_KEY

Verwenden Sie Streamable HTTP mit dem oben genannten Endpunkt und Bearer-Header.

Verfügbare Tools

Die Tools sind auf die App beschränkt, zu der Ihr API-Schlüssel gehört. Rufen Sie zuerst list_products auf, wenn Sie gültige Produktcodes ermitteln müssen.

list_products

Listet Produkte, Preise, Abrechnungsmultiplikatoren und Antwortfelder auf.

Parameter

Keine Parameter

check_number

Prüft eine E-Mail-Adresse synchron. registered ist das primäre Ergebnis.

Parameter

service_type · string · erforderlich
identifier · string · erforderlich

check_numbers

Prüft 1–100 E-Mails mit einem service_type und behält die Eingabereihenfolge bei.

Parameter

service_type · string · erforderlich
identifiers · string[] · erforderlich · max. 100

get_balance

Liest das aktuelle Kontoguthaben, ohne es zu belasten.

Parameter

Keine Parameter

Beispiel-Prompts

Fragen Sie Ihren Assistenten nach der Verbindung in natürlicher Sprache:

Prüfe, ob name@example.com zustellbar ist – ob die Adresse Nachrichten empfangen kann.
Prüfe diese 20 E-Mails und fasse die Ergebnisse zusammen.
Wie viel Guthaben ist noch übrig, bevor ich diesen Stapel ausführe?

Fehlerbehandlung

Tool-Fehler verwenden isError=true und denselben code-, msg-, data-Vertrag wie die API.

Beispiel für einen Tool-Fehler

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}

Code	Beschreibung
`40000`Ungültiges Produkt oder Feld	Nicht unterstützter service_type oder widersprüchliche Felder.
`40002`Ungültige E-Mail-Adresse	Die übermittelte E-Mail-Adresse hat kein gültiges Format.
`40100`Fehlender oder ungültiger API-Schlüssel	Prüfen Sie den Bearer-Header und stellen Sie sicher, dass der Schlüssel aktiv ist.
`40200`Unzureichendes Guthaben	Die Anfrage wird vor der Verarbeitung abgelehnt, wenn der volle Betrag für den Stapel nicht gedeckt werden kann.
`42200`Unbestimmt	Die E-Mail-Adresse konnte derzeit nicht ermittelt werden. Es wird kein Ergebnis zurückgegeben, und dieser Aufruf wird nicht berechnet.
`42901`Parallelitätsbudget ausgeschöpft	Alle fünf Plätze für gleichzeitige Anfragen sind belegt, oder auf diesem Konto läuft bereits eine Mehrfachprüfung. Nicht berechnet; versuchen Sie es erneut, sobald eine abgeschlossen ist.
`50303`Dienst ausgelastet	Plattformweit laufen zu viele Prüfungen. Nicht berechnet; warten Sie die in Retry-After angegebenen Sekunden ab und senden Sie erneut.
`50400`Zeitüberschreitung bei der Prüfung	Nicht rechtzeitig abgeschlossen. Nicht berechnet; eine Mehrfachprüfung mit Zeitüberschreitung schlägt als Ganzes fehl und wird vollständig erstattet.
`50300`Wartung des Dienstes	Versuchen Sie es später erneut.