MCP Server

WhatsApp untuk
AI agents

Endpoint MCP remote di POST /mcp. 24 tools out-of-the-box. Auth sama dengan REST: satu API key untuk Cursor, Claude (via custom connector), dan client MCP lain yang support Streamable HTTP.

24 Tools tersedia
JSON-RPC 2.0 Spec 2025-03-26
Stateless Per-request
Bearer Auth standard
Why MCP

AI agent yang bisa kirim WhatsApp

Model Context Protocol adalah standar terbuka dari Anthropic untuk LLM bicara ke tools. Kirimdev expose 24 tools (list akun, kirim pesan, kelola kontak, sync template) lewat satu URL.

Compatible dengan client MCP apapun

Pakai Cursor, Claude (custom connectors), atau client custom yang paham Streamable HTTP transport. Tinggal arahkan ke https://api.kirimdev.com/mcp + bearer token, tidak perlu konfigurasi terpisah.

  • Auth identik dengan REST API, tidak perlu kredensial baru
  • Service-layer direct call, tidak loopback HTTP, latency rendah
  • Stateless per-request, aman untuk multi-tenant edge deploy
  • Rate limit di-share dengan REST, predictable
mcp-client-config.json
// MCP client config (Cursor ~/.cursor/mcp.json,
// dan client lain yang support Streamable HTTP)
{
  "mcpServers": {
    "kirimdev": {
      "url": "https://api.kirimdev.com/mcp",
      "headers": {
        "Authorization": "Bearer kdv_live_..."
      }
    }
  }
}
24 Tools

Semua yang AI butuhkan

Curated subset dari REST surface. Setiap tool dibuat untuk natural-language workflow, lengkap dengan deskripsi argumen yang AI bisa baca.

list_phone_numbers

Discover WhatsApp accounts yang terkoneksi. Selalu call ini dulu untuk dapat phone_number_id.

send_message

Kirim text, image, document, video, audio, template, atau interactive payload, sesuai schema Meta.

mark_as_read

Read receipt untuk pesan masuk, optional typing indicator. Otomatis flip status local ke read.

list_conversations

Browse percakapan, filter by status (open, resolved, pending) atau contact.

get_conversation

Fetch single thread plus N pesan terakhir inline. Context lengkap untuk LLM dalam satu round-trip.

search_contacts

Lookup by phone (E.164) atau substring nama/email, sebelum send-message untuk verifikasi recipient.

create_contact

Tambah kontak baru dengan nama, email, dan metadata custom. Update juga tersedia.

list_templates

List approved Meta templates. Plus sync_templates untuk force-pull dari Meta Business Manager.

customers + setup_link

Multi-tenant tools: create customer, generate one-time setup link untuk end-tenant Meta Embedded Signup.

Natural language → WhatsApp action

AI agent paham context, chain tool calls otomatis, lalu mengeksekusi. Tidak perlu menulis glue code. Klien Anda cukup bicara, agent yang handle.

Contoh disamping: instruksi tunggal dari user, lima tool calls otomatis oleh Claude, yaitu list akun, list conversation, cari kontak, kirim pesan, mark as read.

claude-session.log
// Human ke Claude:
"Cek conversation yang open di nomor +6281...,
balas pesan terakhir dari Budi dengan
konfirmasi pengiriman besok jam 10."

// Claude (in background, via MCP):
list_phone_numbers()
list_conversations({ status: 'open' })
search_contacts({ search: 'Budi' })
send_message({
  to: '+6281...',
  type: 'text',
  text: { body: 'Halo Budi, ...' }
})
mark_as_read(...)
Note: MCP server menggunakan auth yang sama persis dengan REST API. Satu API key untuk SDK, REST, dan MCP, tidak ada token management terpisah.
Use Cases

Yang bisa dibuat

Customer support

Auto-triage masuk

AI baca incoming message, klasifikasi, assign ke tim yang tepat, balas dengan template, semua di latar belakang.

Sales ops

Outreach personal

Agent cari lead, riset, generate pesan personal, kirim. Workflow yang biasanya butuh 5 tools dijadikan satu prompt.

Internal tools

AI agent sebagai dashboard

Tim ops bertanya "berapa conversation open di akun A?" via Cursor atau Claude dan dapat jawaban langsung. No dashboard navigation.

Setup di MCP client dalam 2 menit

Generate API key, tempel ke config MCP client (Cursor / Claude custom connector / dll), restart. Done.