Referensi

AvatarLookup Referensi MCP

Model Context Protocol memungkinkan aplikasi AI memanggil alat eksternal selama percakapan. Minta asisten Anda memeriksa avatar sebuah akun atau meninjau satu batch tanpa menulis integrasi API terpisah.

MCP adalah adaptor protokol. MCP menggunakan produk, saldo, penagihan, batas konkurensi, batas waktu, dan semantik hasil yang sama dengan REST API.

Produk, harga, dan batasan ada di referensi API

Autentikasi

Gunakan kunci API yang persis sama dengan REST API dan tambahkan sebagai token Bearer di konfigurasi klien MCP Anda.

Header Authorization

Authorization: Bearer YOUR_API_KEY

Jaga kerahasiaan kunci API AndaTambahkan kunci hanya ke konfigurasi klien tepercaya milik Anda sendiri. Jangan pernah mengeksposnya di kode browser atau prompt publik.

URL server

Arahkan klien Anda ke endpoint Streamable HTTP resmi. Tidak memerlukan proses MCP lokal.

Item	Nilai
Endpoint MCP	https://avatarlookup.com/mcp
Streamable HTTP	Permintaan menggunakan JSON-RPC melalui Streamable HTTP dan middleware kunci API yang sama dengan REST.

Hubungkan klien Anda

Pilih format konfigurasi yang didukung klien Anda. Ganti placeholder dengan kunci API Anda.

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

Tambahkan server jarak jauh dari terminal Anda.

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

Tambahkan entri server ini ke konfigurasi MCP klien.

Alat yang tersedia

Alat-alat ini dibatasi pada aplikasi pemilik kunci API Anda. Panggil list_products terlebih dahulu jika Anda perlu mengetahui kode produk yang valid.

list_products

Menampilkan daftar produk, harga, pengali penagihan, dan field respons.

Parameter

Tanpa parameter

check_number

Mencari satu pengenal secara sinkron. avatar dan avatar_url adalah hasil utamanya.

Parameter

service_type · string · wajib
identifier · string · wajib

check_numbers

Memeriksa 1–100 pengenal dengan satu service_type dan mempertahankan urutan input.

Parameter

service_type · string · wajib
identifiers · string[] · wajib · maks. 100

get_balance

Membaca saldo akun saat ini tanpa menagihnya.

Parameter

Tanpa parameter

Contoh prompt

Setelah terhubung, tanyakan kepada asisten Anda dengan bahasa sehari-hari:

Apakah +17253100591 memiliki avatar WhatsApp? Berikan URL gambarnya.
Periksa avatar untuk 20 email ini dan rangkum hasilnya.
Berapa sisa saldo sebelum saya menjalankan batch ini?

Penanganan error

Kegagalan alat menggunakan isError=true dan kontrak code, msg, data yang sama dengan API.

Contoh error alat

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

Kode	Deskripsi
`40000`Produk atau field tidak valid	service_type tidak didukung atau field saling bertentangan.
`40002`Pengenal tidak valid	Pengenal yang dikirim tidak dalam format yang valid.
`40100`Kunci API tidak ada atau tidak valid	Periksa header Bearer dan pastikan kunci masih aktif.
`40200`Saldo tidak mencukupi	Permintaan ditolak sebelum diproses jika jumlah seluruh batch tidak dapat ditutupi.
`42200`Tidak dapat ditentukan	Pengenal tidak dapat ditentukan saat ini. Tidak ada hasil yang dikembalikan, dan panggilan ini tidak ditagih.
`42901`Kuota konkurensi penuh	Kelima slot permintaan berjalan sedang sibuk, atau pemeriksaan multi sedang berjalan di akun ini. Tidak ditagihkan; coba lagi setelah salah satunya selesai.
`50303`Layanan mencapai kapasitas penuh	Terlalu banyak pemeriksaan yang sedang berjalan di seluruh platform. Tidak ditagihkan; tunggu selama Retry-After detik lalu kirim ulang.
`50400`Waktu pemeriksaan habis	Tidak selesai tepat waktu. Tidak ditagihkan; pemeriksaan multi yang melewati batas waktu gagal secara keseluruhan dan dikembalikan sepenuhnya.
`50300`Pemeliharaan layanan	Coba lagi nanti.