Referensi

WA Lookup Referensi MCP

Model Context Protocol adalah standar terbuka yang memungkinkan aplikasi AI memanggil alat eksternal selama percakapan. Setelah terhubung, Anda dapat meminta asisten Anda memeriksa nomor atau meninjau satu batch tanpa menulis integrasi API terpisah.

MCP adalah adaptor protokol, bukan sistem validasi terpisah. 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 yang Anda gunakan untuk REST API. Buat atau salin dari Pengaturan, lalu 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 menempelkannya ke prompt publik, meng-commit-nya ke kontrol sumber, atau mengeksposnya di kode browser.

URL server

Server menggunakan transport Streamable HTTP resmi. Arahkan klien Anda ke satu endpoint ini; tidak diperlukan proses MCP lokal.

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

Hubungkan klien Anda

Kami mendukung Claude Code, Cursor / Claude Desktop, dan klien MCP lain yang mendukung Streamable HTTP. Pilih tab yang sesuai di bawah dan ganti placeholder dengan kunci API Anda.

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

Tambahkan server jarak jauh dari terminal Anda.

{
  "mcpServers": {
    "wachecker": {
      "url": "https://walookup.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 yang tersedia untuk kunci API ini, termasuk harga, pengali tagihan, tujuan, dan field respons.

Parameter

Tanpa parameter

check_number

Memeriksa satu nomor yang dikirim secara sinkron. registered adalah hasil utama; avatar dan business adalah field produk opsional.

Parameter

service_type · string · wajib
identifier · string · wajib

check_numbers

Memeriksa 1–100 nomor dengan satu service_type. Hasil mempertahankan urutan input; setiap nomor dievaluasi secara terpisah dan nomor yang gagal tidak menghentikan nomor lainnya.

Parameter

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

get_balance

Membaca saldo akun saat ini. Bersifat hanya-baca dan tidak membuat pemeriksaan atau menagih akun.

Parameter

Tanpa parameter

Contoh prompt

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

Periksa apakah +17253100591 terdaftar di WhatsApp.
Periksa 20 nomor ini dan rangkum hasil yang terdaftar dan tidak terdaftar.
Tampilkan produk yang tersedia untuk kunci API saya beserta harganya.
Berapa sisa saldo sebelum saya menjalankan batch ini?

Penanganan error

Kegagalan alat dikembalikan dengan isError=true sehingga klien dapat menjelaskan apa yang terjadi alih-alih menganggap koneksi terputus. Kegagalan bisnis menggunakan 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`Nomor tidak valid	Format nomor yang dikirim tidak 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	Nomor tidak dapat ditentukan saat ini. Tidak ada hasil yang dikembalikan, dan panggilan ini tidak ditagihkan.
`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.