MCP server

Indeks dokumentasi

Ambil indeks dokumentasi lengkap di: llms.txt Pakai file ini buat nemu semua halaman sebelum eksplor lebih jauh.

Project MCP kasih agen AI akses tool langsung buat kirim pesan, baca percakapan, atur template, dan konfigurasi webhook di nomor WhatsApp kamu.

Pakai ini kalau agen yang support MCP perlu operasikan nomor WhatsApp tanpa akses shell — baca pesan masuk, kirim balasan, kelola template, atur webhook, dan cek channel.

Endpoint:

https://api.wazapin.com/mcp

Discovery (tanpa auth): GET https://api.wazapin.com/.well-known/wazapin-mcp.json — daftar nama tool, action, dan header auth.

Scope API key (MCP)

Kamu bisa batasi tool MCP pakai JSON scopes di API key:

Kalau scopes kosong = nggak ada batasan MCP (tetap dibatasi Casbin di REST).

Authentication

Pilih opsi auth yang didukung klien MCP kamu:

• API key (disarankan): bikin API key organisasi di dashboard dan kirim lewat header. Key harus diawali wzp_. Konteks organisasi kebaca otomatis dari key.
• Session bearer: pakai token sesi dashboard sebagai Authorization: Bearer … kalau klien kamu sudah login dengan organization yang aktif.

Dua-duanya buka tool Project MCP yang sama selama caller punya izin.

Header API key yang diterima:

Authorization: Bearer [REDACTED]

X-Api-Key: YOUR_API_KEY

Pakai Authorization: Bearer buat klien bearer-token. Pakai X-Api-Key kalau klien MCP kamu bisa atur custom header.

Connect

API key

Set API key kamu:

export WAZAPIN_API_KEY="wzp_your_key"

claude mcp add --transport http wazapin https://api.wazapin.com/mcp \
  --header "X-Api-Key: $WAZAPIN_API_KEY"

{
  "mcpServers": {
    "wazapin": {
      "url": "https://api.wazapin.com/mcp",
      "headers": {
        "X-Api-Key": "${env:WAZAPIN_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "wazapin": {
      "url": "https://api.wazapin.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WAZAPIN_API_KEY}"
      }
    }
  }
}

Pakai Authorization Bearer

Ganti header-nya kalau klien kamu lebih cocok pakai Bearer:

{
  "mcpServers": {
    "wazapin": {
      "url": "https://api.wazapin.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WAZAPIN_API_KEY}"
      }
    }
  }
}

Tools

Project MCP sediain tool yang dikelompokkan. Kebanyakan tool pakai action dan params.

Pakai action: "help" di tiap tool grup buat lihat daftar action dan contoh payload.

Contoh

Minta agen cek setup:

Pakai MCP server wazapin buat cek status project aku dan kasih tahu next action-nya.

Minta agen baca dan kirim pesan WhatsApp:

Pakai wazapin conversations dengan action=list buat list percakapan open terbaru, lalu messages dengan action=list buat thread paling baru.

Pakai wazapin messages dengan action=send buat kirim "Halo dari Wazapin" ke +6281234567890 dari channel aku yang sudah terhubung.

Atur outbound webhook:

Pakai wazapin webhooks dengan action=list, lalu jelasin event type apa yang bisa aku subscribe.

Project MCP vs docs

Pakai REST API atau TypeScript SDK kalau agen kamu bisa akses HTTP atau kode. Pakai Project MCP kalau agen kamu support MCP dan mau panggil tool Wazapin langsung.