Referenz

WA Lookup MCP-Referenz

Das Model Context Protocol ist ein offener Standard, mit dem KI-Anwendungen während einer Unterhaltung externe Tools aufrufen können. Nach der Verbindung können Sie Ihren Assistenten bitten, eine Nummer zu prüfen oder einen Stapel auszuwerten, ohne eine separate API-Integration zu schreiben.

MCP ist ein Protokolladapter, kein eigenständiges Prüfsystem. 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. Erstellen oder kopieren Sie ihn in den Einstellungen und fügen Sie ihn dann als Bearer-Token in die Konfiguration Ihres MCP-Clients ein.

Authorization-Header

Authorization: Bearer YOUR_API_KEY

Halten Sie Ihren API-Schlüssel privatFügen Sie den Schlüssel nur in die Konfiguration Ihres eigenen, vertrauenswürdigen Clients ein. Fügen Sie ihn niemals in einen öffentlichen Prompt ein, committen Sie ihn nicht in die Versionsverwaltung und legen Sie ihn nicht im Browser-Code offen.

Server-URL

Der Server nutzt den offiziellen Streamable-HTTP-Transport. Richten Sie Ihren Client auf diesen einen Endpunkt aus; ein lokaler MCP-Prozess ist nicht erforderlich.

Eintrag	Wert
MCP-Endpunkt	https://walookup.com/mcp
Streamable HTTP	Anfragen verwenden JSON-RPC über Streamable HTTP und werden von derselben API-Schlüssel-Middleware authentifiziert wie die REST-Endpunkte.

Client verbinden

Wir unterstützen Claude Code, Cursor / Claude Desktop und jeden anderen MCP-Client, der Streamable HTTP beherrscht. Wählen Sie unten den passenden Tab und ersetzen Sie den Platzhalter durch Ihren API-Schlüssel.

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

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

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

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

URL: https://walookup.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 die für diesen API-Schlüssel verfügbaren Produkte auf, einschließlich Preisen, Abrechnungsmultiplikatoren, Verwendungszwecken und Antwortfeldern.

Parameter

Keine Parameter

check_number

Prüft eine übermittelte Nummer synchron. registered ist das Hauptergebnis; avatar und business sind optionale Produktfelder.

Parameter

service_type · string · erforderlich
identifier · string · erforderlich

check_numbers

Prüft 1–100 Nummern mit einem service_type. Die Ergebnisse behalten die Eingabereihenfolge bei; jede Nummer wird unabhängig ausgewertet, und eine fehlgeschlagene Nummer hält die übrigen nicht auf.

Parameter

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

get_balance

Liest das aktuelle Kontoguthaben aus. Nur lesend – es wird keine Prüfung erstellt und dem Konto nichts berechnet.

Parameter

Keine Parameter

Beispiel-Prompts

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

Prüfen Sie, ob +17253100591 bei WhatsApp registriert ist.
Prüfen Sie diese 20 Nummern und fassen Sie registrierte und nicht registrierte Ergebnisse zusammen.
Zeigen Sie mir die für meinen API-Schlüssel verfügbaren Produkte und ihre Preise.
Wie viel Guthaben ist noch übrig, bevor ich diesen Stapel ausführe?

Fehlerbehandlung

Tool-Fehler werden mit isError=true zurückgegeben, damit der Client erklären kann, was passiert ist, statt die Verbindung als gestört zu behandeln. Geschäftliche Fehler verwenden 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 Nummer	Die übermittelte Nummer 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 Nummer konnte derzeit nicht bestimmt 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.