Başvuru

CarrierLookup 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 numarayı sorgulamasını 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 tamamen aynı API anahtarını kullanın ve bunu 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 tarayıcı kodunda veya herkese açık istemlerde açığa çıkarmayın.

Sunucu URL'si

İstemcinizi resmî Streamable HTTP uç noktasına yönlendirin. Yerel bir MCP işlemi gerekmez.

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

İ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 carrierlookup https://carrierlookup.online/mcp --header "Authorization: Bearer YOUR_API_KEY"

Uzak sunucuyu terminalinizden ekleyin.

{
  "mcpServers": {
    "carrierlookup": {
      "url": "https://carrierlookup.online/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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

URL: https://carrierlookup.online/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 numarayı senkron olarak sorgular. Sonucun üst düzeyindeki operatör alanları birincil yanıttır.

Parametreler

service_type · string · zorunlu
identifier · string · zorunlu

check_numbers

Tek bir service_type ile 1–100 numarayı kontrol eder ve girdi sırasını korur.

Parametreler

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

get_balance

Mevcut hesap bakiyesini ücret almadan okur.

Parametreler

Parametre yok

Örnek istemler

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

+17253100591 numarasının ilk hangi operatöre tahsis edildiğini sorgula.
Bu 20 numarayı 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 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.