Başvuru

WA Lookup MCP başvurusu

Model Context Protocol, yapay zekâ uygulamalarının bir sohbet sırasında harici araçları çağırmasını sağlayan açık bir standarttır. Bağlandıktan sonra, ayrı bir API entegrasyonu yazmadan asistanınızdan bir numarayı kontrol etmesini veya bir grubu incelemesini isteyebilirsiniz.

MCP ayrı bir doğrulama sistemi değil, 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 için kullandığınız API anahtarının aynısını kullanın. Ayarlar'dan oluşturun veya kopyalayın, ardından 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 kendi güvendiğiniz istemci yapılandırmasına ekleyin. Asla herkese açık bir istem içine yapıştırmayın, kaynak kontrolüne commit etmeyin veya tarayıcı kodunda açığa çıkarmayın.

Sunucu URL'si

Sunucu, resmî Streamable HTTP taşıma katmanını kullanır. İstemcinizi bu tek uç noktaya yönlendirin; yerel bir MCP işlemi gerekmez.

Öğe	Değer
MCP uç noktası	https://walookup.com/mcp
Streamable HTTP	İstekler Streamable HTTP üzerinden JSON-RPC kullanır ve REST uç noktalarıyla aynı API anahtarı ara katmanı tarafından doğrulanır.

İstemcinizi bağlayın

Claude Code, Cursor / Claude Desktop ve Streamable HTTP destekleyen diğer tüm MCP istemcilerini destekliyoruz. Aşağıdan uygun sekmeyi seçin ve yer tutucuyu API anahtarınızla değiştirin.

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

Uzak sunucuyu terminalinizden ekleyin.

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

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

URL: https://walookup.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

Bu API anahtarı için kullanılabilen ürünleri; fiyatlar, faturalandırma çarpanları, amaçlar ve yanıt alanlarıyla birlikte listeler.

Parametreler

Parametre yok

check_number

Gönderilen bir numarayı senkron olarak kontrol eder. registered birincil sonuçtur; avatar ve business isteğe bağlı ürün alanlarıdır.

Parametreler

service_type · string · zorunlu
identifier · string · zorunlu

check_numbers

Tek bir service_type ile 1–100 numarayı kontrol eder. Sonuçlar girdi sırasını korur; her numara bağımsız olarak değerlendirilir ve başarısız bir numara diğerlerini durdurmaz.

Parametreler

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

get_balance

Mevcut hesap bakiyesini okur. Salt okunurdur; kontrol oluşturmaz veya hesaptan ücret almaz.

Parametreler

Parametre yok

Örnek istemler

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

+17253100591 numarasının WhatsApp'ta kayıtlı olup olmadığını kontrol et.
Bu 20 numarayı kontrol et ve kayıtlı ile kayıtsız sonuçları özetle.
API anahtarım için kullanılabilen ürünleri ve fiyatlarını göster.
Bu grubu çalıştırmadan önce ne kadar bakiye kaldı?

Hata yönetimi

Araç hataları isError=true ile döndürülür, böylece istemci bağlantıyı bozuk saymak yerine ne olduğunu açıklayabilir. İş hataları, 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 numara	Gönderilen numara 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	Numara ş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.