Referensi API
Referensi lengkap untuk semua tool MCP yang tersedia untuk chatbot Anda.
Tool Baca
Tool ini tersedia dengan scope baca-saja. Chatbot Anda dapat mengambil data keuangan tanpa membuat perubahan.
- list_transactions – Lihat semua transaksi dengan filter opsional (rentang tanggal, tag, jumlah). Memerlukan
read:transactions. - get_transaction_summary – Total agregat transaksi. Memerlukan
read:transactions. - list_budgets / get_budget_status – Lihat anggaran dan pemanfaatan. Memerlukan
read:budgets. - list_goals / get_goal_progress – Lihat tujuan keuangan. Memerlukan
read:goals. - list_wallets / get_wallet_balance – Lihat dompet dan saldo. Memerlukan
read:wallets. - search_product_knowledge – Cari di basis pengetahuan bantuan dan FAQ. Memerlukan
read:knowledge. - whoami – Mengembalikan user ID, token ID, dan scope Anda. Memerlukan
meta:whoami. - list_capabilities – Daftar semua tool MCP yang tersedia untuk token Anda. Memerlukan
meta:whoami. - list_bill_reminders – Lihat pengingat tagihan mendatang dan berulang. Memerlukan
read:bills. - list_recurring_transactions – Lihat transaksi berulang (terjadwal). Memerlukan
read:recurring. - calculate – Evaluasi ekspresi aritmatika yang aman. Memerlukan
read:knowledge. - ask_moneysaurus – Ajukan pertanyaan keuangan dalam bahasa natural dan dapatkan jawaban bahasa natural. Baca-saja, dan tidak pernah mengekspos ID internal. Memerlukan
ask:agent.
Tool Tulis (Beta)
Tool tulis memungkinkan chatbot Anda membuat dan mengubah data keuangan. Ketersediaan bergantung pada konfigurasi server Anda. Scope tulis harus diberikan ke token Anda.
Tool tulis sangat kuat—berikan scope tulis hanya ke chatbot yang Anda percaya. Setiap operasi tulis dicatat di log audit.
- Setiap operasi tulis memerlukan idempotency_key (UUIDv4) untuk mencegah duplikasi tidak sengaja.
- Gunakan dry_run: true untuk memvalidasi input tanpa membuat perubahan aktual.
- Semua tulisan yang dikomit dicatat di log audit.
- Tool tulis mungkin dinonaktifkan oleh administrator server Anda.
| Tool | Scope |
|---|---|
| create_transaction | write:transactions |
| update_transaction | write:transactions |
| delete_transaction | write:transactions |
| create_budget | write:budgets |
| update_budget | write:budgets |
| delete_budget | write:budgets |
| create_goal | write:goals |
| update_goal | write:goals |
| delete_goal | write:goals |
| add_goal_funds | write:goals |
| create_wallet | write:wallets |
| update_wallet | write:wallets |
| delete_wallet | write:wallets |
| create_bill_reminder | write:bills |
| update_bill_reminder | write:bills |
| delete_bill_reminder | write:bills |
| create_recurring_transaction | write:recurring |
| update_recurring_transaction | write:recurring |
| delete_recurring_transaction | write:recurring |
Batas Rate
Untuk memastikan penggunaan yang adil, server MCP menerapkan batas rate per token:
| Endpoint | Batas |
|---|---|
| POST /api/v1/mcp (JSON-RPC) | 120 permintaan/menit per token |
| GET /api/v1/mcp/sse (koneksi) | 30 koneksi/menit per token |
| POST /api/v1/mcp-tokens (buat) | 10/jam per pengguna |