Referensi tools MCP
Vaulty menyediakan 46 alat. Daftar ini dibaca langsung dari kode server, jadi selalu sama dengan yang tersedia. Versi protokol: 2025-06-18.
Semua jumlah memakai mata uang pencatatan organisasi (lihat get_organization), bukan selalu rupiah. Jawaban berupa teks JSON. Alat tulis butuh token dengan akses tulis, dan alat hapus wajib confirm: true (data masuk tong sampah 30 hari). Alat tabungan, tagihan, utang, skor kesehatan, dan peta panas hanya tersedia di paket Personal ke atas.
Ringkasan dan analisis
get_organization (Baca)
Info organisasi: nama, paket, mata uang pencatatan, peran kamu, jumlah anggota, dan fitur mana yang tersedia di paketnya. Panggil ini lebih dulu kalau ragu fitur apa yang bisa dipakai.
Tanpa parameter
get_summary (Baca)
Total pemasukan, pengeluaran, selisih, lima kategori pengeluaran terbesar, dan pemakaian anggaran untuk satu bulan.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
get_cashflow (Baca)
Arus kas beberapa bulan terakhir: pemasukan, pengeluaran, dan selisih per bulan (maksimal 24 bulan).
| Parameter | Type | |
|---|---|---|
months | integer | Jumlah bulan, 1 sampai 24. Default 6. |
end_month | string | Bulan terakhir, format YYYY-MM. Default bulan ini. |
get_insights (Baca)
Insight pengeluaran satu bulan: porsi tiap kategori. Di paket Family ditambah perbandingan dengan bulan lalu, proyeksi akhir bulan, dan pengeluaran per anggota.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
get_report (Baca)
Data laporan keuangan satu bulan atau seluruh periode: pemasukan dan pengeluaran per kategori, anggaran vs realisasi, dan ringkasan tabungan. Ini data, bukan file PDF atau Excel.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
get_financial_health (Baca)
Skor kesehatan keuangan 0 sampai 100 untuk satu bulan beserta rincian empat komponennya dan rekomendasi. Paket Personal ke atas.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
get_daily_spending (Baca)
Pengeluaran per hari dalam satu bulan (data peta panas): total tiap hari, tingkat intensitas, hari paling boros, dan rata-rata harian. Paket Personal ke atas.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
Transaksi
list_transactions (Baca)
Transaksi terbaru (pemasukan dan pengeluaran), bisa disaring per jenis, bulan, dan kategori.
| Parameter | Type | |
|---|---|---|
type | income | expense | all | Jenis: income atau expense (list_transactions juga boleh all). |
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
category | string | Nama kategori. |
limit | integer | Jumlah baris, 1 sampai 100. |
add_transaction (Tulis)
Mencatat satu pemasukan atau pengeluaran. Butuh token dengan akses tulis. Cek list_categories dulu supaya kategori dan metode sesuai. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
type (wajib) | income | expense | Jenis: income atau expense (list_transactions juga boleh all). |
amount (wajib) | number | Jumlah dalam mata uang pencatatan organisasi. |
category (wajib) | string | Nama kategori. |
name (wajib) | string | Nama atau keterangan singkat. |
date | string | Tanggal YYYY-MM-DD. Kosong = hari ini. |
method | string | Metode pembayaran. Kosong = metode pertama di daftar. |
note | string | Catatan tambahan. |
update_transaction (Tulis)
Mengubah satu pemasukan atau pengeluaran. Hanya kirim field yang mau diubah. Transaksi yang terhubung ke tabungan atau tagihan ditolak: pakai alat tabungan atau tagihan.
| Parameter | Type | |
|---|---|---|
type (wajib) | income | expense | Jenis: income atau expense (list_transactions juga boleh all). |
id (wajib) | string | ID dari alat list_*. |
date | string | Tanggal YYYY-MM-DD. Kosong = hari ini. |
name | string | Nama atau keterangan singkat. |
category | string | Nama kategori. |
method | string | Metode pembayaran. Kosong = metode pertama di daftar. |
amount | number | Jumlah dalam mata uang pencatatan organisasi. |
note | string | Catatan tambahan. |
delete_transaction (Hapus)
Menghapus satu transaksi (masuk tong sampah 30 hari). Wajib confirm: true setelah menanyakan pengguna.
| Parameter | Type | |
|---|---|---|
type (wajib) | income | expense | Jenis: income atau expense (list_transactions juga boleh all). |
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Anggaran
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. |
set_budget (Tulis)
Membuat atau mengubah anggaran satu kategori untuk satu bulan. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
category (wajib) | string | Nama kategori. |
amount (wajib) | number | Jumlah dalam mata uang pencatatan organisasi. |
rollover | boolean | Bawa sisa anggaran ke bulan berikutnya. |
delete_budget (Hapus)
Menghapus anggaran satu kategori di satu bulan. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
month (wajib) | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
category (wajib) | string | Nama kategori. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Kategori dan aturan otomatis
list_categories (Baca)
Daftar kategori pemasukan, kategori pengeluaran, dan metode pembayaran yang dipakai organisasi. Pakai nilai ini saat mencatat transaksi.
Tanpa parameter
add_category (Tulis)
Menambah kategori pemasukan, kategori pengeluaran, atau metode pembayaran.
| Parameter | Type | |
|---|---|---|
kind (wajib) | income | expense | payment_method | Jenis (Tabungan atau Investasi untuk tabungan; income, expense, payment_method untuk kategori). |
name (wajib) | string | Nama atau keterangan singkat. |
delete_category (Hapus)
Menghapus kategori atau metode pembayaran. Transaksi lama tidak berubah. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
kind (wajib) | income | expense | payment_method | Jenis (Tabungan atau Investasi untuk tabungan; income, expense, payment_method untuk kategori). |
name (wajib) | string | Nama atau keterangan singkat. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
list_categorization_rules (Baca)
Aturan kategori otomatis (pola teks yang diarahkan ke kategori tertentu).
Tanpa parameter
add_categorization_rule (Tulis)
Membuat aturan kategori otomatis: kalau nama transaksi memuat pola tertentu, arahkan ke kategori tertentu.
| Parameter | Type | |
|---|---|---|
type (wajib) | expense | income | Jenis: income atau expense (list_transactions juga boleh all). |
pattern (wajib) | string | Pola teks yang dicari di nama transaksi. |
category (wajib) | string | Nama kategori. |
priority | integer | Urutan prioritas, bilangan bulat. |
active | boolean | Aktif atau tidak. |
update_categorization_rule (Tulis)
Mengubah aturan kategori otomatis.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
type | expense | income | Jenis: income atau expense (list_transactions juga boleh all). |
pattern | string | Pola teks yang dicari di nama transaksi. |
category | string | Nama kategori. |
priority | integer | Urutan prioritas, bilangan bulat. |
active | boolean | Aktif atau tidak. |
delete_categorization_rule (Hapus)
Menghapus aturan kategori otomatis. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Tabungan dan target
list_savings (Baca)
Tabungan dan investasi: saldo tiap akun dan riwayat setoran serta penarikan terbaru. Paket Personal ke atas.
| Parameter | Type | |
|---|---|---|
limit | integer | Jumlah baris, 1 sampai 100. |
add_savings_entry (Tulis)
Mencatat setoran atau penarikan tabungan atau investasi (paket Personal ke atas). Setoran otomatis tercatat sebagai pengeluaran, penarikan sebagai uang kembali ke dompet tanpa dihitung sebagai pemasukan. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
date | string | Tanggal YYYY-MM-DD. Kosong = hari ini. |
kind (wajib) | Tabungan | Investasi | Jenis (Tabungan atau Investasi untuk tabungan; income, expense, payment_method untuk kategori). |
account (wajib) | string | Nama akun tabungan atau investasi. |
deposit | number | Setoran, 0 atau lebih. |
withdrawal | number | Penarikan, 0 atau lebih. |
note | string | Catatan tambahan. |
update_savings_entry (Tulis)
Mengubah catatan tabungan. Setoran dan penarikan terhubungnya ikut disesuaikan.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
date | string | Tanggal YYYY-MM-DD. Kosong = hari ini. |
kind | Tabungan | Investasi | Jenis (Tabungan atau Investasi untuk tabungan; income, expense, payment_method untuk kategori). |
account | string | Nama akun tabungan atau investasi. |
deposit | number | Setoran, 0 atau lebih. |
withdrawal | number | Penarikan, 0 atau lebih. |
note | string | Catatan tambahan. |
delete_savings_entry (Hapus)
Menghapus catatan tabungan beserta pengeluaran atau pemasukan terhubungnya. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
list_savings_targets (Baca)
Target menabung beserta progres, sisa, hari tersisa, dan saran setoran per bulan. Paket Personal ke atas.
Tanpa parameter
add_savings_target (Tulis)
Membuat target menabung terhubung ke satu akun tabungan (paket Personal ke atas). Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
name (wajib) | string | Nama atau keterangan singkat. |
target_amount (wajib) | number | Nominal target, lebih dari 0. |
start_date | string | Tanggal mulai YYYY-MM-DD. Default hari ini. |
target_date (wajib) | string | Tanggal target YYYY-MM-DD. |
linked_account (wajib) | string | Akun tabungan yang dipakai menghitung progres. |
update_savings_target (Tulis)
Mengubah target menabung. Hanya kirim field yang berubah.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
name | string | Nama atau keterangan singkat. |
target_amount | number | Nominal target, lebih dari 0. |
start_date | string | Tanggal mulai YYYY-MM-DD. Default hari ini. |
target_date | string | Tanggal target YYYY-MM-DD. |
linked_account | string | Akun tabungan yang dipakai menghitung progres. |
delete_savings_target (Hapus)
Menghapus target menabung. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Tagihan
list_bills (Baca)
Tagihan berulang beserta status bulan tertentu (paid, unpaid, overdue). Paket Personal ke atas.
| Parameter | Type | |
|---|---|---|
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
add_bill (Tulis)
Membuat tagihan berulang tiap bulan (paket Personal ke atas). Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
name (wajib) | string | Nama atau keterangan singkat. |
category (wajib) | string | Nama kategori. |
amount (wajib) | number | Jumlah dalam mata uang pencatatan organisasi. |
due_day (wajib) | integer | Tanggal jatuh tempo tiap bulan, 1 sampai 31. |
starts_from | string | Mulai bulan YYYY-MM. Default bulan ini. |
ends_at | string | Berakhir bulan YYYY-MM, atau "ongoing" (default). |
note | string | Catatan tambahan. |
active | boolean | Aktif atau tidak. |
update_bill (Tulis)
Mengubah tagihan berulang. Hanya kirim field yang berubah.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
name | string | Nama atau keterangan singkat. |
category | string | Nama kategori. |
amount | number | Jumlah dalam mata uang pencatatan organisasi. |
due_day | integer | Tanggal jatuh tempo tiap bulan, 1 sampai 31. |
starts_from | string | Mulai bulan YYYY-MM. Default bulan ini. |
ends_at | string | Berakhir bulan YYYY-MM, atau "ongoing" (default). |
note | string | Catatan tambahan. |
active | boolean | Aktif atau tidak. |
delete_bill (Hapus)
Menghapus tagihan beserta riwayat pembayarannya. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
pay_bill (Tulis)
Menandai tagihan lunas untuk satu bulan dan mencatat pengeluarannya. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
bill_id (wajib) | string | ID tagihan dari list_bills. |
month | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
amount | number | Jumlah dalam mata uang pencatatan organisasi. |
paid_at | string | Tanggal bayar YYYY-MM-DD. Default hari ini. |
unpay_bill (Hapus)
Membatalkan status lunas satu bulan beserta pengeluaran terhubungnya. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
bill_id (wajib) | string | ID tagihan dari list_bills. |
month (wajib) | string | Bulan, format YYYY-MM. Kosong = bulan ini. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Utang dan piutang
list_debts (Baca)
Utang dan piutang beserta sisa dan status. Paket Personal ke atas.
| Parameter | Type | |
|---|---|---|
include_payments | boolean | Sertakan riwayat pembayaran. Default false. |
add_debt (Tulis)
Mencatat utang (owed, kamu berutang) atau piutang (receivable, orang lain berutang ke kamu). Paket Personal ke atas. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
direction (wajib) | owed | receivable | owed (kamu berutang) atau receivable (orang lain berutang ke kamu). |
name (wajib) | string | Nama atau keterangan singkat. |
principal (wajib) | number | Pokok utang. |
remaining | number | Sisa. Default sama dengan pokok. |
interest_rate | number | Bunga dalam persen. Default 0. |
due_date | string | Jatuh tempo YYYY-MM-DD (opsional). |
note | string | Catatan tambahan. |
update_debt (Tulis)
Mengubah data utang atau piutang. Hanya kirim field yang berubah.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
direction | owed | receivable | owed (kamu berutang) atau receivable (orang lain berutang ke kamu). |
name | string | Nama atau keterangan singkat. |
principal | number | Pokok utang. |
remaining | number | Sisa. Default sama dengan pokok. |
interest_rate | number | Bunga dalam persen. Default 0. |
due_date | string | null | Jatuh tempo YYYY-MM-DD (opsional). |
status | active | paid | active atau paid. |
note | string | Catatan tambahan. |
delete_debt (Hapus)
Menghapus utang beserta riwayat pembayarannya. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
pay_debt (Tulis)
Mencatat cicilan utang atau penerimaan piutang dan mengurangi sisanya. Tidak boleh melebihi sisa. Jumlah dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
amount (wajib) | number | Jumlah dalam mata uang pencatatan organisasi. |
paid_at | string | Tanggal bayar YYYY-MM-DD. Default hari ini. |
note | string | Catatan tambahan. |
Kekayaan bersih
list_net_worth (Baca)
Aset dan kewajiban untuk kekayaan bersih, beserta totalnya.
Tanpa parameter
add_net_worth_item (Tulis)
Menambah aset (asset) atau kewajiban (liability) untuk kekayaan bersih. Nilai dalam mata uang pencatatan organisasi (lihat get_organization).
| Parameter | Type | |
|---|---|---|
type (wajib) | asset | liability | Jenis: income atau expense (list_transactions juga boleh all). |
name (wajib) | string | Nama atau keterangan singkat. |
category (wajib) | string | Nama kategori. |
value (wajib) | number | Nilai aset atau kewajiban. |
as_of_date | string | Tanggal nilai YYYY-MM-DD. Default hari ini. |
note | string | Catatan tambahan. |
update_net_worth_item (Tulis)
Mengubah item kekayaan bersih. Hanya kirim field yang berubah.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
type | asset | liability | Jenis: income atau expense (list_transactions juga boleh all). |
name | string | Nama atau keterangan singkat. |
category | string | Nama kategori. |
value | number | Nilai aset atau kewajiban. |
as_of_date | string | Tanggal nilai YYYY-MM-DD. Default hari ini. |
note | string | Catatan tambahan. |
delete_net_worth_item (Hapus)
Menghapus item kekayaan bersih. Wajib confirm: true.
| Parameter | Type | |
|---|---|---|
id (wajib) | string | ID dari alat list_*. |
confirm (wajib) | boolean | Harus true. Tanyakan dulu ke pengguna sebelum menghapus. |
Riwayat dan tong sampah
list_activity (Baca)
Log aktivitas organisasi terbaru: siapa menambah, mengubah, atau menghapus apa.
| Parameter | Type | |
|---|---|---|
limit | integer | Jumlah baris, 1 sampai 100. |
list_trash (Baca)
Data yang baru dihapus dan masih bisa dipulihkan dalam 30 hari. Pemulihannya lewat menu Tong sampah di aplikasi.
Tanpa parameter