monapay-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MONAPAY_BASE_URL | No | Base URL of the MONA Pay API. | https://api.monapay.vn |
| MONAPAY_PASSWORD | Yes | MONA Pay password. | |
| MONAPAY_USERNAME | Yes | MONA Pay login username. | |
| MONAPAY_CLIENT_SECRET | No | client_secret (API key) generated in the dashboard or via the monapay_generate_key tool, used for write commands. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| monapay_meA | Lấy thông tin tài khoản MONA Pay đang đăng nhập (id, tên, trạng thái). / Get current MONA Pay client profile. |
| monapay_list_bank_accountsA | Liệt kê tài khoản ngân hàng (ACB…) đã nối vào MONA Pay. / List linked bank accounts. |
| monapay_list_virtual_accountsA | Liệt kê tài khoản ảo thuộc một tài khoản ngân hàng. / List virtual accounts of a bank account. |
| monapay_create_qrA | Tạo mã VietQR động điền sẵn số tiền + nội dung cho một đơn hàng qua ACB. Khách quét là tiền vào tài khoản ảo, MONA Pay bắn webhook. / Create a dynamic VietQR for an order. |
| monapay_cancel_qrB | Huỷ một mã VietQR động đã tạo. / Cancel a dynamic QR. |
| monapay_list_transactionsB | Liệt kê giao dịch tiền vào theo tài khoản ảo, phân trang tối đa 100/trang; dùng để đối soát. / List incoming transactions. |
| monapay_list_webhooksA | Liệt kê webhook đã cấu hình. / List webhook configs. |
| monapay_create_webhookC | Đăng ký URL nhận webhook khi có tiền vào; khuyến nghị auth_type HMAC_SHA256 + secret_key. / Create a webhook config. |
| monapay_update_webhookC | Cập nhật webhook (URL, secret, bật/tắt). / Update a webhook config. |
| monapay_delete_webhookC | Xoá một webhook config. / Delete a webhook config. |
| monapay_test_webhookB | MONA Pay gửi một giao dịch giả (is_dummy) tới URL để kiểm tra endpoint + chữ ký. / Send a dummy webhook. |
| monapay_webhook_logsB | Lịch sử từng lần gửi (HTTP code, thời gian phản hồi, nhãn lỗi). / Webhook delivery logs. |
| monapay_webhook_statsB | Tỷ lệ thành công, P95, phân loại lỗi. / Webhook delivery stats. |
| monapay_retry_transactionB | Gửi lại webhook hoặc Telegram cho giao dịch đã có. / Re-send webhook/Telegram for a transaction. |
| monapay_generate_keyB | Sinh client_secret mới (hiện 1 lần) để dùng header X-Client-Secret. / Generate a client secret. |
| monapay_verify_signatureA | Tính và so chữ ký HMAC-SHA256 của một webhook MONA Pay từ raw body + timestamp + secret, không gọi mạng. / Verify a webhook signature locally. |
| monapay_generate_webhook_snippetA | Trả code mẫu endpoint nhận webhook MONA Pay + verify HMAC đúng chuẩn cho PHP / Node / Python, kèm payload mẫu. / Get a webhook receiver snippet. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| integrate-monapay | Hướng dẫn agent tích hợp nhận tiền chuyển khoản tự động bằng MONA Pay theo 6 bước |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| monapay-llms | Mục lục tài liệu MONA Pay dạng máy đọc |
TDQS
Scored across 17 tools
Each tool targets a distinct resource and action: profile, bank accounts, virtual accounts, QR codes, transactions, webhooks, and signature/key utilities. Even the webhook-related tools are cleanly separated by operation (create/update/delete/test/logs/stats). There is no meaningful overlap between tool responsibilities.
All tools share the consistent monapay_ prefix, and most follow a clear monapay_verb_noun pattern. Minor deviations exist, such as monapay_me, monapay_webhook_logs, and monapay_webhook_stats, which read as noun phrases rather than action-oriented names, but the overall convention is still predictable.
17 tools is slightly above the typical sweet spot for a well-scoped MCP server, but each tool earns its place in the payment/webhook lifecycle. QR management, webhook CRUD, webhook diagnostics, transaction lookup, and signature verification are all meaningful separate concerns.
The server covers the full incoming-payment workflow: QR creation/cancellation, bank/virtual account discovery, transaction reconciliation, webhook configuration and delivery monitoring, retry, and local HMAC verification. There are no obvious dead ends for the stated purpose of integrating with MONA Pay webhooks and VietQR payments.