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.

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 fügen Sie ihn 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. 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.

EintragWert
MCP-Endpunkthttps://avatarlookup.com/mcp
Streamable HTTPAnfragen 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.

Parameter
Keine Parameter

check_number

Fragt eine Kennung synchron ab. avatar und avatar_url sind das primäre Ergebnis.

Parameter
service_type · string · erforderlich
identifier · string · erforderlich

check_numbers

Prüft 1–100 Kennungen 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 etwas zu berechnen.

Parameter
Keine Parameter

Beispiel-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
}
CodeBeschreibung
40000Ungültiges Produkt oder FeldNicht unterstützter service_type oder widersprüchliche Felder.
40002Ungültige KennungDie übermittelte Kennung hat kein gültiges Format.
40100Fehlender oder ungültiger API-SchlüsselPrüfen Sie den Bearer-Header und stellen Sie sicher, dass der Schlüssel aktiv ist.
40200Unzureichendes GuthabenDie Anfrage wird vor der Verarbeitung abgelehnt, wenn der volle Betrag für den Stapel nicht gedeckt werden kann.
42200UnbestimmtDie Kennung konnte derzeit nicht bestimmt werden. Es wird kein Ergebnis zurückgegeben, und dieser Aufruf wird nicht berechnet.
42901Parallelitätsbudget ausgeschöpftAlle 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 ausgelastetPlattformweit 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üfungNicht rechtzeitig abgeschlossen. Nicht berechnet; eine Mehrfachprüfung mit Zeitüberschreitung schlägt als Ganzes fehl und wird vollständig erstattet.
50300Wartung des DienstesVersuchen Sie es später erneut.