Başvuru

AvatarLookup MCP başvurusu

Model Context Protocol, yapay zekâ uygulamalarının bir sohbet sırasında harici araçları çağırmasını sağlar. Ayrı bir API entegrasyonu yazmadan asistanınızdan bir hesabın profil fotoğrafını kontrol etmesini veya bir grubu incelemesini isteyin.

MCP bir protokol bağdaştırıcısıdır. REST API ile aynı ürünleri, bakiyeyi, faturalandırmayı, eşzamanlılık sınırlarını, zaman aşımlarını ve sonuç anlamlarını kullanır.

Ürünler, fiyatlandırma ve sınırlar API başvurusunda yer alır

Kimlik doğrulama

REST API ile birebir aynı API anahtarını kullanın ve MCP istemci yapılandırmanıza Bearer token olarak ekleyin.

Authorization başlığı

Authorization: Bearer YOUR_API_KEY

API anahtarınızı gizli tutunAnahtarı yalnızca güvendiğiniz kendi istemci yapılandırmanıza ekleyin. Asla tarayıcı kodunda veya herkese açık istemlerde açığa çıkarmayın.

Sunucu URL'si

İstemcinizi resmi Streamable HTTP uç noktasına yönlendirin. Yerel bir MCP süreci gerekmez.

Öğe	Değer
MCP uç noktası	https://avatarlookup.com/mcp
Streamable HTTP	İstekler Streamable HTTP üzerinden JSON-RPC ve REST ile aynı API anahtarı ara katmanını kullanır.

İstemcinizi bağlayın

İstemcinizin desteklediği yapılandırma biçimini seçin. Yer tutucuyu API anahtarınızla değiştirin.

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

Uzak sunucuyu terminalinizden ekleyin.

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

Bu sunucu girdisini istemcinin MCP yapılandırmasına ekleyin.

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

Yukarıdaki uç nokta ve Bearer başlığıyla Streamable HTTP kullanın.

Kullanılabilir araçlar

Araçlar, API anahtarınızın ait olduğu uygulamayla sınırlıdır. Geçerli ürün kodlarını keşfetmeniz gerektiğinde önce list_products aracını çağırın.

list_products

Ürünleri, fiyatları, faturalandırma çarpanlarını ve yanıt alanlarını listeler.

Parametreler

Parametre yok

check_number

Bir tanımlayıcıyı senkron olarak sorgular. avatar ve avatar_url birincil sonuçtur.

Parametreler

service_type · string · zorunlu
identifier · string · zorunlu

check_numbers

Tek bir service_type ile 1–100 tanımlayıcıyı kontrol eder ve giriş sırasını korur.

Parametreler

service_type · string · zorunlu
identifiers · string[] · zorunlu · en fazla 100

get_balance

Güncel hesap bakiyesini ücretlendirmeden okur.

Parametreler

Parametre yok

Örnek istemler

Bağlandıktan sonra asistanınıza sade bir dille sorun:

+17253100591 numarasının WhatsApp profil fotoğrafı var mı? Görsel URL'sini ver.
Bu 20 e-postanın profil fotoğraflarını kontrol et ve sonuçları özetle.
Bu grubu çalıştırmadan önce ne kadar bakiye kaldı?

Hata yönetimi

Araç hataları isError=true ve API ile aynı code, msg, data sözleşmesini kullanır.

Örnek araç hatası

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

Kod	Açıklama
`40000`Geçersiz ürün veya alan	Desteklenmeyen service_type veya çelişen alanlar.
`40002`Geçersiz tanımlayıcı	Gönderilen tanımlayıcı geçerli bir biçimde değil.
`40100`Eksik veya geçersiz API anahtarı	Bearer başlığını kontrol edin ve anahtarın etkin olduğunu doğrulayın.
`40200`Yetersiz bakiye	Grubun tamamının tutarı karşılanamadığında istek işlenmeden önce reddedilir.
`42200`Belirlenemedi	Tanımlayıcı şu anda belirlenemedi. Sonuç döndürülmez ve bu çağrı ücretlendirilmez.
`42901`Eşzamanlılık kotası dolu	Beş eşzamanlı istek yuvasının tamamı meşgul veya bu hesapta zaten bir çoklu kontrol çalışıyor. Ücret alınmaz; biri bittiğinde yeniden deneyin.
`50303`Hizmet tam kapasitede	Platform genelinde devam eden çok fazla kontrol var. Ücret alınmaz; Retry-After saniye kadar bekleyin ve yeniden gönderin.
`50400`Kontrol zaman aşımına uğradı	Zamanında tamamlanmadı. Ücret alınmaz; zaman aşımına uğrayan bir çoklu kontrol bütünüyle başarısız olur ve tamamı iade edilir.
`50300`Hizmet bakımda	Daha sonra yeniden deneyin.