MCP Server

WhatsApp untuk
AI agents

Endpoint MCP remote di POST /mcp. 17 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.

17 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 17 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 ngerti 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 buat 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_..."
      }
    }
  }
}
17 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 ngerti context, chain tool calls otomatis, dan ngeksekusi. Tidak perlu nulis glue code. Klien Anda cukup ngomong, agent yang handle.

Contoh disamping: instruksi tunggal dari user, lima tool calls otomatis oleh Claude — 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 dibikin

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 dijadiin satu prompt.

Internal tools

AI agent sebagai dashboard

Tim ops nanya "berapa conversation open di akun A?" via Cursor atau Claude dan dapet jawab 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.