Referenz
AvatarLookup MCP-Referenz
Das Model Context Protocol ermöglicht KI-Anwendungen, während einer Unterhaltung externe Tools aufzurufen. Bitten Sie Ihren Assistenten, das Profilbild eines Kontos zu prüfen oder einen Stapel auszuwerten, ohne eine separate API-Integration zu schreiben.
MCP ist ein Protokolladapter. Es nutzt dieselben Produkte, dasselbe Guthaben, dieselbe Abrechnung, dieselben Parallelitätslimits, Zeitlimits und Ergebnisbedeutungen wie die REST-API.
Authentifizierung
Verwenden Sie genau denselben API-Schlüssel wie für die REST-API und fügen Sie ihn als Bearer-Token in die Konfiguration Ihres MCP-Clients ein.
Authorization: Bearer YOUR_API_KEYHalten Sie Ihren API-Schlüssel privatFügen Sie den Schlüssel nur in die Konfiguration Ihres eigenen vertrauenswürdigen Clients ein. Geben Sie ihn niemals in Browser-Code oder öffentlichen Prompts preis.
Server-URL
Richten Sie Ihren Client auf den offiziellen Streamable-HTTP-Endpunkt aus. Es ist kein lokaler MCP-Prozess erforderlich.
| Eintrag | Wert |
|---|---|
| MCP-Endpunkt | https://avatarlookup.com/mcp |
| Streamable HTTP | Anfragen verwenden 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 avatarlookup https://avatarlookup.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Fügen Sie den Remote-Server über Ihr Terminal hinzu.
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.
Keine Parametercheck_number
Fragt eine Kennung synchron ab. avatar und avatar_url sind das primäre Ergebnis.
service_type · string · erforderlich
identifier · string · erforderlichcheck_numbers
Prüft 1–100 Kennungen mit einem service_type und behält die Eingabereihenfolge bei.
service_type · string · erforderlich
identifiers · string[] · erforderlich · max. 100get_balance
Liest das aktuelle Kontoguthaben, ohne etwas zu berechnen.
Keine ParameterBeispiel-Prompts
Fragen Sie Ihren Assistenten nach der Verbindung in natürlicher Sprache:
Hat +17253100591 ein WhatsApp-Profilbild? Gib mir die Bild-URL.
Prüfe diese 20 E-Mail-Adressen auf Profilbilder 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 |
|---|---|
40000Ungültiges Produkt oder Feld | Nicht unterstützter service_type oder widersprüchliche Felder. |
40002Ungültige Kennung | Die übermittelte Kennung hat kein gültiges Format. |
40100Fehlender oder ungültiger API-Schlüssel | Prüfen Sie den Bearer-Header und stellen Sie sicher, dass der Schlüssel aktiv ist. |
40200Unzureichendes Guthaben | Die Anfrage wird vor der Verarbeitung abgelehnt, wenn der volle Betrag für den Stapel nicht gedeckt werden kann. |
42200Unbestimmt | Die Kennung konnte derzeit nicht bestimmt werden. Es wird kein Ergebnis zurückgegeben, und dieser Aufruf wird nicht berechnet. |
42901Parallelitä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. |
50303Dienst ausgelastet | Plattformweit laufen zu viele Prüfungen. Nicht berechnet; warten Sie die in Retry-After angegebenen Sekunden ab und senden Sie erneut. |
50400Zeitü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. |
50300Wartung des Dienstes | Versuchen Sie es später erneut. |