{"endpoint":"https://kumu.my/mcp","documentation":"https://kumu.my/mcp","transport":"http","protocolVersion":"2025-06-18","auth":"Authorization: Bearer ***","token":"https://kumu.my/laman?mcp=1","tools":[{"name":"get_limits","description":"Baca had pelan dan penggunaan semasa akaun: laman, fail, storan, borang, kolum satu borang, data satu borang, produk, dan had kadar MCP. Panggil ini sebelum mencipta laman, borang atau produk supaya tidak melanggar had."},{"name":"sdk_guide","description":"Panduan menggunakan KUMU untuk halaman jualan: laluan borang, medan, produk, CHIP, halaman terima kasih dan kos pos. Mula dengan topik \"ringkasan\" (lima langkah). Topik: ringkasan, borang, awam, produk, chip, terima_kasih, pos, digital, servis."},{"name":"list_sites","description":"Senaraikan laman milik akaun ini: slug, nama, alamat awam (domain tersuai didahulukan), versi yang hidup, dan sama ada laman dijeda."},{"name":"list_files","description":"Senaraikan fail dalam satu laman, dengan saiz setiap satu."},{"name":"read_file","description":"Baca satu fail teks dalam laman. Fail binari ditolak, dan begitu juga fail melebihi mengikut had pelan anda."},{"name":"write_file","description":"Tulis atau ganti satu fail teks dalam laman, sehingga mengikut had pelan anda satu fail (bilangan yang dibenarkan pelan anda). Perubahan masuk ke draf, belum ke live: panggil publish_site selepas ini untuk menerbitkannya."},{"name":"delete_file","description":"Buang satu fail daripada draf laman. Versi yang sedang hidup belum berubah, jadi panggil publish_site selepas ini untuk membuangnya dari alamat awam juga. Fail yang tidak ada tidak menjadi ralat."},{"name":"create_site","description":"Cipta laman baharu dalam akaun ini. Had pelan ini mengikut had pelan anda, dan setiap laman boleh memegang bilangan yang dibenarkan pelan anda. Laman baharu kosong sehingga fail ditulis dan diterbitkan."},{"name":"list_forms","description":"Senaraikan borang akaun ini: kunci, kolum, dan berapa baris sudah tersimpan. Borang inilah tempat satu laman menyimpan apa yang orang hantar kepadanya. Had pelan ini mengikut had pelan anda, dan mengikut had pelan anda."},{"name":"read_form","description":"Baca baris yang sudah tersimpan dalam satu borang, terbaharu dahulu, dengan id setiap baris. Tapis ikut tarikh dengan dari_tarikh/hingga_tarikh. Guna ini untuk melihat apa yang orang sudah hantar sebelum menjawab balik atau mengemasnya (delete_form_rows)."},{"name":"form_stats","description":"Statistik satu borang, sama seperti tab Statistik dalam konsol: setiap kolum dengan MAKNA yang dibaca daripada nilainya (nombor, wang, tarikh, yatidak, pilihan, lokasi, identiti, teks), nilai yang digabung (\"ya\"/\"YES\"/\"hadir\" = Ya, \"KL\" = Kuala Lumpur), dan widget papan yang sudah dikira (jumlah, purata, peratus, graf harian, carta). Guna ini untuk menjawab soalan tentang data (\"berapa tetamu hadir?\", \"negeri mana paling ramai?\") tanpa membaca setiap baris. Tapis dengan tapis: [{ kolum, nilai }], cth. [{ kolum: \"negeri\", nilai: \"Johor\" }], untuk soalan bersyarat. Emel dan telefon hanya dikira, nilainya tidak dipulangkan."},{"name":"set_column_meaning","description":"Tetapkan makna kolum borang bila tekaan dalam form_stats salah, cth. kolum q3 sebenarnya bilangan pax. Makna yang disimpan menjadi disahkan, dan papan serta graf ikut makna itu. Kolum emel/telefon kekal identiti dan tidak boleh ditukar."},{"name":"set_form_dashboard","description":"Susun papan statistik borang (tab Statistik dalam konsol). Hantar senarai widget dalam turutan paparan, maksimum 16, atau null untuk kembali ke papan auto. Setiap widget: { jenis, kolum, tajuk?, kira?, nilai?, ukur?, had? }. jenis: kad | garis | bar | donut | heatmap | jadual. kolum ialah kunci kolum, atau _masa (masa hantar) dan _hasil (RM dibayar, borang berbayar sahaja). kad perlukan kira: kiraan | jumlah | purata | min | max | unik | peratus (peratus perlukan nilai, cth. \"Ya\"). garis untuk _masa atau kolum tarikh; bar/donut untuk kolum yatidak, pilihan, lokasi atau nombor; heatmap untuk _masa sahaja. ukur (garis/bar/donut) menjumlahkan kolum nombor, cth. jumlah pax ikut negeri. Panggil form_stats dahulu untuk makna kolum. Papan yang tidak sesuai ditolak dengan sebab."},{"name":"delete_form_rows","description":"Padam baris tertentu daripada satu borang, ikut id dari read_form (maksimum 50 satu panggilan). Tanya pemilik dahulu: hantar confirm: true hanya selepas pemilik setuju. Baris yang dipadam hilang dari konsol dan CSV. Pesanan yang sudah dibayar tidak boleh dipadam di sini."},{"name":"create_form","description":"Cipta borang untuk satu laman supaya laman itu menyimpan apa yang orang hantar, bukan kehilangannya. Ia memulangkan snippet HTML: tampal blok itu dalam halaman dengan write_file, kemudian publish_site. Kolum boleh ditanda unik, supaya nombor telefon atau e-mel yang sudah ada ditolak dan bukan disimpan dua kali. Borang juga ada had baris mengikut pelan, dan hantaran ditolak bila penuh. Kolum bertanda awam boleh dipaparkan kepada pelawat (papan skor, buku tetamu): sdk_guide topik awam. Had mengikut had pelan anda satu akaun, mengikut had pelan anda."},{"name":"update_form","description":"Ubah nama, kolum atau ayat satu borang yang sudah ada. Kuncinya kekal, kerana ia alamat yang snippet di laman sudah hantar."},{"name":"list_products","description":"Senaraikan produk akaun ini untuk borang berbayar: id (p_...), nama, harga dalam sen, stok, sama ada dijual, jenis (fizikal/digital/servis), fail produk digital dan jadual produk servis. Id inilah yang dipakai dalam create_form/update_form (bayar.produk). Had mengikut had pelan anda satu akaun, pelan berbayar sahaja."},{"name":"save_product","description":"Cipta produk baharu (tanpa id) atau kemas kini satu (dengan id). Harga dalam sen: RM45.00 = 4500, minimum 100. Id produk tidak pernah berubah, jadi snippet borang yang sudah ditampal kekal betul bila nama atau harga diubah. Had mengikut had pelan anda."},{"name":"delete_product","description":"Padam satu produk. Borang yang menjualnya akan menyoroknya; pesanan lama tidak berubah."},{"name":"payment_status","description":"Keadaan integrasi pembayaran akaun ini (CHIP, Billplz, ToyyibPay atau Stripe): dibuka atau tidak, mod (uji/live), kunci mana yang sudah disimpan (petunjuk sahaja, tiada rahsia), dan berapa bayaran menunggu pengesahan. Kunci gerbang hanya boleh dimasukkan oleh pemilik di konsol (Akaun → Integrasi), tidak melalui alat ini."},{"name":"set_payment_mode","description":"Buka atau tutup penerimaan bayaran, dan pilih mod uji (sandbox, kad ujian) atau live (wang sebenar). Mod live hanya boleh diaktifkan bila kunci Live sudah disimpan oleh pemilik. Tanya pemilik dahulu sebelum menukar ke live."},{"name":"delete_form","description":"Padam satu borang bersama semua baris yang sudah tersimpan di dalamnya. Laman yang memakai snippetnya berhenti menyimpan."},{"name":"list_versions","description":"Senaraikan versi terbit satu laman, terbaharu dahulu, dengan saiz dan masa. Versi hidup ditanda live."},{"name":"restore_version","description":"Jadikan satu versi lama versi hidup semula. Draf dan laman awam kedua-duanya dikembalikan kepada versi itu."},{"name":"publish_site","description":"Terbitkan draf laman supaya perubahan dilihat pada alamat awamnya. Hanya fail yang berubah dimuat naik, dan draf yang sama dengan versi hidup tidak menyimpan versi baharu: selamat memanggilnya lebih daripada sekali."},{"name":"unpublish_site","description":"Turunkan laman dari udara. Fail dan versi kekal, draf tidak berubah: publish_site menghidupkannya semula."},{"name":"pause_site","description":"Jeda atau sambung semula satu laman. Laman yang dijeda tidak menjawab, tetapi fail, versi dan alamatnya kekal."},{"name":"set_domain","description":"Beri satu laman alamatnya: nama domain tersuai akaun ini (laman menjawab di <domain>/<slug>), atau \"subdomain\" untuk alamat percuma. Dua alamat itu berasingan dan masing-masing ada akarnya sendiri. Satu domain boleh memegang banyak laman; menghantar utama: true memindahkan akar domain kepada laman ini. Alat ini tidak menambah domain baharu (itu di https://kumu.my/laman kerana melibatkan DNS). Hantar on: false untuk melepaskan alamat itu dan kembali ke alamat percuma."}]}