Referensi tools MCP
Vaulty menyediakan 5 alat. Daftar ini dibaca langsung dari kode server, jadi selalu sama dengan yang tersedia. Versi protokol: 2025-06-18.
Semua jumlah dalam Rupiah (IDR). Jawaban berupa teks JSON.
get_summary (Baca)
Total pemasukan, pengeluaran, selisih, lima kategori pengeluaran terbesar, dan kategori anggaran yang terlampaui untuk satu bulan.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini (atau semua bulan untuk list_transactions). |
list_transactions (Baca)
Transaksi terbaru (pemasukan dan pengeluaran). Bisa disaring per jenis, bulan, dan kategori. Maksimal 100 baris.
| Parameter | Type | |
|---|---|---|
type | income | expense | all | income, expense, atau all (list_transactions). income atau expense saja untuk add_transaction. |
month | string | Bulan, format YYYY-MM. Kosong = bulan ini (atau semua bulan untuk list_transactions). |
category | string | Nama kategori. |
limit | integer | Jumlah baris, 1 sampai 100. Default 20. |
list_budgets (Baca)
Anggaran per kategori untuk satu bulan beserta jumlah yang sudah terpakai dan sisanya.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini (atau semua bulan untuk list_transactions). |
list_categories (Baca)
Kategori pemasukan, kategori pengeluaran, dan metode pembayaran milik organisasi. Panggil ini sebelum mencatat transaksi.
Tanpa parameter
add_transaction (Tulis)
Mencatat satu pemasukan atau pengeluaran. Butuh token dengan akses tulis. Hanya menambah, tidak bisa mengubah atau menghapus.
| Parameter | Type | |
|---|---|---|
type (wajib) | income | expense | income, expense, atau all (list_transactions). income atau expense saja untuk add_transaction. |
amount (wajib) | number | Jumlah dalam Rupiah, lebih dari 0. |
category (wajib) | string | Nama kategori. |
name (wajib) | string | Keterangan singkat: sumber pemasukan atau nama pengeluaran. |
date | string | Tanggal YYYY-MM-DD. Kosong = hari ini. |
method | string | Metode pembayaran. Kosong = metode pertama di daftar. |
note | string | Catatan tambahan (maks 500 karakter). |