vn.monapay/monapay-mcp
NPM · MONAPAY-MCP · SCANNED SEP 26
MONA Pay for AI agents: create VietQR, check bank transfers, webhooks & HMAC. Vietnam bank API, VND
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 95 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 6 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability83
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 4691 tokens (~91/item across 51 items; 50 tools + 1 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage80
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 41% of tool parameters carry a description.Partial
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "monapay_delete_webhook" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 52 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
How do I install the vn.monapay/monapay-mcp server?
vn.monapay/monapay-mcp runs locally as an npm package, launched with npx -y monapay-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · monapay-mcp
claude mcp add vn-monapay-monapay-mcp -- npx -y monapay-mcp
{
"mcpServers": {
"vn-monapay-monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
]
}
}
} {
"servers": {
"vn-monapay-monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
]
}
}
} codex mcp add vn-monapay-monapay-mcp -- npx -y monapay-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"vn-monapay-monapay-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"monapay-mcp"
],
"enabled": true
}
}
} openclaw mcp add vn-monapay-monapay-mcp --command npx --arg -y --arg monapay-mcp
mcp_servers:
vn-monapay-monapay-mcp:
command: "npx"
args: ["-y", "monapay-mcp"] {
"McpServers": {
"vn-monapay-monapay-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"monapay-mcp"
]
}
}
} assistant mcp add vn-monapay-monapay-mcp -t stdio -c npx -a -y monapay-mcp
{
"mcpServers": {
"vn-monapay-monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 25 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 20 Sept 26 +11
- Known CVEs: unverified → pass ▲ security
- Dependency health: unverified → 0.85 ▲ functional
- 19 Sept 26 58
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 26 Sept 2026 · Analysed npm/monapay-mcp@0.6.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 95 packages
| Packages resolved | 95 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
monapay_cancel_checkout Huỷ phiên thanh toán ~72
Huỷ checkout đang pending; checkout đã paid, expired hoặc cancelled không thể huỷ lại. / Cancel a pending checkout.
| Name | Type | Req | Description |
|---|---|---|---|
| checkout_id | string | yes | ID phiên thanh toán |
| idempotency_key | string | – | Khoá chống tạo trùng; bỏ trống để MCP tự sinh UUID |
No output schema declared.
No examples provided.
monapay_cancel_qr Huỷ mã QR ~36
Huỷ một mã VietQR động đã tạo. / Cancel a dynamic QR.
| Name | Type | Req | Description |
|---|---|---|---|
| qr_code_id | string | yes | – |
No output schema declared.
No examples provided.
monapay_create_checkout Tạo link thu tiền ~191
Tạo link thu tiền, đưa link cho khách hoặc chuyển hướng checkout; đợi webhook CHECKOUT_PAID trước khi giao hàng. / Create a hosted checkout link; wait for CHECKOUT_PAID before fulfilment.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | integer | yes | Số tiền nguyên VND |
| cancel_url | string | – | – |
| description | string | – | – |
| expires_in | integer | – | – |
| idempotency_key | string | – | Khoá chống tạo trùng; bỏ trống để MCP tự sinh UUID |
| metadata | object | – | – |
| order_code | string | yes | – |
| payer_email | string | – | – |
| payer_name | string | – | – |
| return_url | string | yes | – |
| sandbox | boolean | – | true = phiên THỬ với VA sandbox, không tiền thật; dùng được khi chưa nối ngân hàng |
| virtual_account_id | string | – | – |
No output schema declared.
No examples provided.
monapay_create_email_config Tạo cấu hình thông báo email ~166
Tạo kênh thông báo email. Sau khi tạo, MONA Pay gửi mã 6 số tới từng địa chỉ; hỏi người dùng mã rồi gọi monapay_verify_email; không tự đoán mã. / Create an email notification config. MONA Pay sends a 6-digit code to each address; ask the user for each code, call monapay_verify_email, and never guess a code.
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | – | Sự kiện gửi email; luôn phải có TRANSACTION_IN |
| name | string | yes | Tên cấu hình |
| recipients | array | yes | Từ 1 đến 10 địa chỉ nhận email |
| virtual_account_id | string | – | Chỉ nhận thông báo cho VA này; bỏ trống = mọi tài khoản |
No output schema declared.
No examples provided.
monapay_create_qr Tạo VietQR động cho đơn hàng ~237
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.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | integer | yes | Số tiền VND (số nguyên) |
| beneficiaryName | string | yes | Tên đơn vị hưởng |
| description | string | – | Nội dung chuyển khoản, nên chứa mã đơn |
| loyaltyCode | string | – | – |
| merchantId | string | yes | Mã merchant (hiển thị ở dashboard mục Tạo QR) |
| orderId | string | yes | Mã đơn hàng của hệ thống anh chị |
| ownerNumber | string | yes | Số tài khoản ACB nhận tiền |
| ownerType | string | – | PER cá nhân / ORG doanh nghiệp |
| terminalId | string | – | – |
| traceNumber | string | – | – |
| userId | string | – | – |
| virtualAccountPrefix | string | yes | Đầu số tài khoản ảo đã đăng ký |
| voucherCode | string | – | – |
No output schema declared.
No examples provided.
monapay_create_webhook Tạo cấu hình webhook ~139
Đă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.
| Name | Type | Req | Description |
|---|---|---|---|
| api_key_name | string | – | Tên header khi auth_type=API_KEY, mặc định X-Webhook-Secret |
| auth_type | string | – | – |
| name | string | yes | – |
| payload_format | string | – | – |
| secret_key | string | – | Secret ký HMAC hoặc giá trị API key |
| virtual_account_id | string | – | Chỉ bắn cho VA này; bỏ trống = mọi tài khoản |
| webhook_url | string | yes | – |
No output schema declared.
No examples provided.
monapay_create_zalo_group Nối nhóm Zalo ~175
Nối nhóm có bot Gấu Mona bằng group_id 10–25 chữ số lấy từ MONA Account/PMS; Zalo không parse Markdown, nên template phải là text thuần.
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | – | Các sự kiện gửi vào nhóm Zalo |
| friendly_name | string | yes | Tên dễ nhớ của nhóm |
| group_id | string | yes | group_id gồm 10–25 chữ số, lấy từ MONA Account/PMS |
| is_active | boolean | – | – |
| message_template | string | – | Text thuần; hỗ trợ {amount}, {description}, {virtual_account_number}, {transaction_code}, {transfer_date} và dạng {{...}} |
| virtual_account_id | string | – | Chỉ nhận thông báo cho VA này; bỏ trống = mọi tài khoản |
No output schema declared.
No examples provided.
monapay_delete_email_config Xoá cấu hình thông báo email ~44
Xoá vĩnh viễn một cấu hình email. / Permanently delete an email notification config.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | yes | UUID cấu hình email |
No output schema declared.
No examples provided.
monapay_delete_webhook Xoá cấu hình webhook ~32
Xoá một webhook config. / Delete a webhook config.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | yes | – |
No output schema declared.
No examples provided.
monapay_delete_zalo_group Xoá nhóm Zalo ~47
Xoá một cấu hình thông báo nhóm Zalo.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | ID cấu hình nhóm Zalo do MONA Pay trả về (UUIDv6) |
No output schema declared.
No examples provided.
monapay_email_logs Lịch sử gửi email ~102
Tra meta từng lần gửi email, không chứa nội dung thư; lọc theo cấu hình, trạng thái, sự kiện và ngày. / List email delivery metadata; message bodies are never stored.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | – | – |
| event_type | string | – | – |
| from_date | string | – | – |
| limit | integer | – | – |
| page | integer | – | – |
| status | string | – | – |
| to_date | string | – | – |
No output schema declared.
No examples provided.
monapay_email_stats Thống kê gửi email ~62
Lấy tổng số gửi, tỷ lệ thành công, P95 và nhóm lỗi trong khoảng ngày. / Get email delivery totals, success rate, P95 latency and error groups.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | – |
| to_date | string | – | – |
No output schema declared.
No examples provided.
monapay_generate_key Tạo API key (client_secret) ~43
Sinh client_secret mới (hiện 1 lần) để dùng header X-Client-Secret. / Generate a client secret.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | – | – |
No output schema declared.
No examples provided.
monapay_generate_webhook_snippet Code mẫu nhận webhook ~55
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.
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | yes | – |
No output schema declared.
No examples provided.
monapay_get_checkout Lấy một phiên thanh toán ~50
Lấy trạng thái và chi tiết checkout theo ID; nên kiểm tra server-side trước khi giao hàng. / Get a checkout by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| checkout_id | string | yes | ID phiên thanh toán |
No output schema declared.
No examples provided.
monapay_get_payment_profile Lấy hồ sơ trang thanh toán ~38
Lấy tên shop, nhận diện và tài khoản mặc định dùng cho trang thanh toán. / Get the hosted-checkout payment profile.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_get_transaction Tra 1 giao dich theo ma don hoac ID ~107
Tim 1 giao dich tien vao theo transaction_code (ma don, vd DH10234) hoac id trong mot tai khoan ao; dung de kiem "don X da thanh toan chua". / Get one incoming transaction by code/id within a virtual account.
| Name | Type | Req | Description |
|---|---|---|---|
| id_or_code | string | yes | transaction_code (ma don vd DH10234) hoac transaction id |
| virtual_account_number | string | yes | So VA (tu monapay_list_virtual_accounts) |
No output schema declared.
No examples provided.
monapay_get_transactions_summary Tong tien vao theo khoang (KHONG phai so du vi) ~102
Tong tien vao + so giao dich + du lieu theo ngay trong khoang chon. LUU Y: MONA Pay KHONG giu tien, khong co "so du vi"; day la tong tien da vao tai khoan ngan hang cua ban. / Incoming totals over a date range (MONA Pay holds no wallet balance).
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | – | YYYY-MM-DD |
| start_date | string | – | YYYY-MM-DD |
No output schema declared.
No examples provided.
monapay_link_bank_start Bắt đầu nối ngân hàng ACB và gửi OTP ~262
Bước 1/4: đăng ký tài khoản ACB + VA. OTP do ngân hàng gửi về điện thoại của người dùng; agent phải HỎI người dùng OTP rồi mới gọi tool xác thực, không được tự đoán. / Step 1/4: register the ACB account and VA. The OTP is sent by the bank to the user’s phone; the agent MUST ASK the user before calling the verification tool and must never guess it.
| Name | Type | Req | Description |
|---|---|---|---|
| account_number | – | – | Số tài khoản thanh toán ACB; bắt buộc khi không có bank_account_id |
| bank_account_id | string | – | UUID tài khoản ACB đã nối; khi có, API bỏ qua account_number và phone_number |
| customer_type | string | yes | PERS = cá nhân, ORG = tổ chức |
| description | string | – | Diễn giải đăng ký VA |
| identifier | string | yes | Nội dung định danh VA, tối đa 10 ký tự không dấu |
| phone_number | string | – | Số điện thoại đăng ký với ACB và nhận OTP; bắt buộc khi không có bank_account_id |
| prefix | string | yes | Đầu số VA đã đăng ký với ACB, ví dụ LOC |
No output schema declared.
No examples provided.
monapay_link_bank_verify_otp Xác thực OTP và tạo tài khoản ảo ACB ~133
Bước 2/4: OTP do ngân hàng gửi về điện thoại của người dùng, agent phải HỎI người dùng rồi mới gọi tool này; tuyệt đối không tự đoán OTP. / Step 2/4: the OTP is sent by the bank to the user’s phone; the agent MUST ASK the user before calling this tool and must never guess the OTP.
| Name | Type | Req | Description |
|---|---|---|---|
| acb_request_id | string | yes | ID yêu cầu ACB trả về từ monapay_link_bank_start |
| code | string | yes | OTP do người dùng cung cấp sau khi nhận từ ACB |
No output schema declared.
No examples provided.
monapay_list_bank_accounts Danh sách tài khoản ngân hàng đã nối ~35
Liệt kê tài khoản ngân hàng (ACB…) đã nối vào MONA Pay. / List linked bank accounts.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_list_checkouts Danh sách phiên thanh toán ~81
Liệt kê checkout theo trạng thái, mã đơn, khoảng ngày và phân trang. / List and filter hosted checkouts.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | – |
| limit | integer | – | – |
| order_code | string | – | – |
| page | integer | – | – |
| status | string | – | – |
| to_date | string | – | – |
No output schema declared.
No examples provided.
monapay_list_email_configs Danh sách cấu hình email ~39
Liệt kê các cấu hình gửi thông báo email và trạng thái xác minh người nhận. / List email notification configs and recipient verification status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_list_email_suppressions Danh sách email bị chặn gửi ~38
Liệt kê địa chỉ bị suppression do bounce, khiếu nại hoặc tắt tay. / List suppressed recipient addresses.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_list_transactions Tra giao dịch tiền vào ~85
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| page | integer | – | – |
| virtual_account_number | string | yes | Số tài khoản ảo (bắt buộc; lấy từ monapay_list_virtual_accounts) |
No output schema declared.
No examples provided.
monapay_list_virtual_accounts Danh sách tài khoản ảo (VA) ~57
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.
| Name | Type | Req | Description |
|---|---|---|---|
| bank_account_id | string | yes | UUID tài khoản ngân hàng (lấy từ monapay_list_bank_accounts) |
No output schema declared.
No examples provided.
monapay_list_webhooks Danh sách cấu hình webhook ~24
Liệt kê webhook đã cấu hình. / List webhook configs.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_list_zalo_groups Danh sách nhóm Zalo ~31
Liệt kê cấu hình thông báo nhóm Zalo; nhóm phải có bot Gấu Mona.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_me Hồ sơ tài khoản MONA Pay ~38
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_notification_register Đăng ký thông báo tiền vào và gửi OTP lần 2 ~125
Bước 3/4: đăng ký nhận thông báo giao dịch tức thì. OTP lần 2 do ngân hàng gửi về điện thoại của người dùng; agent phải HỎI người dùng rồi mới gọi tool xác thực, không được tự đoán. / Step 3/4: register real-time transaction notifications. The second OTP is sent by the bank to the user’s phone; the agent MUST ASK the user before verification and must never guess it.
| Name | Type | Req | Description |
|---|---|---|---|
| virtual_account_id | string | yes | ID VA trả về từ monapay_link_bank_verify_otp |
No output schema declared.
No examples provided.
monapay_notification_verify_otp Xác thực OTP lần 2 và hoàn tất nhận tiền ~134
Bước 4/4: OTP do ngân hàng gửi về điện thoại của người dùng, agent phải HỎI người dùng rồi mới gọi tool này; tuyệt đối không tự đoán OTP. / Step 4/4: the OTP is sent by the bank to the user’s phone; the agent MUST ASK the user before calling this tool and must never guess the OTP.
| Name | Type | Req | Description |
|---|---|---|---|
| acb_request_id | string | yes | ID yêu cầu ACB trả về từ monapay_notification_register |
| code | string | yes | OTP lần 2 do người dùng cung cấp sau khi nhận từ ACB |
No output schema declared.
No examples provided.
monapay_quickstart Bat dau nhan tien: kiem tra trang thai va cac buoc tiep theo ~104
DIEM VAO cho y dinh "toi muon nhan tien chuyen khoan tu dong". Goi tool nay TRUOC: no kiem tra tai khoan (da noi ngan hang/VA chua, da co webhook chua) va tra ve cac BUOC TIEP THEO cu the + recipe end-to-end. / Entry point for "I want to receive bank transfers": checks state and returns concrete next steps + recipe.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_remove_email_suppression Gỡ chặn gửi tới một email ~56
Gỡ suppression sau khi đã sửa nguyên nhân; client tự chịu trách nhiệm khi gửi lại. / Remove a suppression after fixing its cause; the client accepts responsibility for future sends.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | – |
No output schema declared.
No examples provided.
monapay_resend_email_verification Gửi lại mã xác minh email ~75
Gửi mã xác minh mới tới một địa chỉ trong cấu hình; giới hạn 5 lần/địa chỉ/giờ. / Resend a verification code, limited to five requests per address per hour.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | yes | UUID cấu hình email |
| string | yes | – |
No output schema declared.
No examples provided.
monapay_retry_transaction Gửi lại thông báo của một giao dịch ~56
Gửi lại webhook hoặc Telegram cho giao dịch đã có. / Re-send webhook/Telegram for a transaction.
| Name | Type | Req | Description |
|---|---|---|---|
| target_id | string | – | – |
| target_type | string | – | – |
| transaction_id | string | yes | – |
No output schema declared.
No examples provided.
monapay_rotate_key Xoay secret API key hiện tại ~71
Dùng khi secret nghi lộ; xoay key hiện tại bằng X-Client-Secret. Sau khi xoay phải cập nhật MONAPAY_CLIENT_SECRET ở plugin/agent rồi khởi động lại. / Rotate the current API key secret after suspected exposure, then update MONAPAY_CLIENT_SECRET.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_sandbox_transaction Tạo giao dịch thử (sandbox, không tốn tiền) ~144
Tạo một giao dịch tiền vào GIẢ: chưa nối ngân hàng thì MONA Pay tự cấp VA sandbox SBX; MONA Pay ghi giao dịch, bắn webhook có chữ ký, gửi Telegram/email/Zalo, khớp checkout như tiền thật, không tính hạn mức. / Create a fake incoming transaction in the sandbox.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | integer | – | – |
| description | string | – | Nội dung chuyển khoản giả; ghi order_code của phiên checkout để phiên đó paid |
| virtual_account_number | string | – | Số VA đã nối; bỏ trống = MONA Pay tự cấp VA sandbox SBX (không cần nối ngân hàng) |
No output schema declared.
No examples provided.
monapay_set_payment_profile Thiết lập hồ sơ trang thanh toán ~179
Tạo hoặc cập nhật tên shop, nhận diện và tài khoản nhận tiền mặc định trước khi tạo checkout. Secret ký redirect chỉ được API trả một lần. / Create or update the hosted-checkout payment profile.
| Name | Type | Req | Description |
|---|---|---|---|
| accent_color | – | – | – |
| beneficiary_name | string | – | – |
| default_bank_account_id | string | – | – |
| default_virtual_account_id | – | – | – |
| display_name | string | – | – |
| hotline | – | – | – |
| locale | string | – | – |
| logo_url | – | – | URL HTTPS của logo, tối đa 512 KB |
| merchant_id | string | – | – |
| owner_number | string | – | – |
| owner_type | string | – | – |
| show_mona_badge | boolean | – | – |
| support_email | – | – | – |
| terminal_id | string | – | – |
| va_prefix | string | – | – |
No output schema declared.
No examples provided.
monapay_test_email Gửi thử thông báo email ~49
Gửi email mẫu tới các địa chỉ đã xác minh trong cấu hình. / Send a test notification to verified recipients in a config.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | yes | UUID cấu hình email |
No output schema declared.
No examples provided.
monapay_test_webhook Bắn webhook thử ~72
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.
| Name | Type | Req | Description |
|---|---|---|---|
| auth_type | string | – | – |
| secret_key | string | – | – |
| webhook_url | string | – | Bỏ trống = dùng config đã lưu |
No output schema declared.
No examples provided.
monapay_test_zalo_group Gửi thử vào nhóm Zalo ~57
Gửi tin thử text thuần; nhóm phải có bot Gấu Mona vì Zalo không parse Markdown.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | ID cấu hình nhóm Zalo do MONA Pay trả về (UUIDv6) |
No output schema declared.
No examples provided.
monapay_update_email_config Sửa cấu hình thông báo email ~118
Cập nhật tên, người nhận, sự kiện, VA hoặc trạng thái bật/tắt của cấu hình email. Người nhận mới phải xác minh trước khi cấu hình hoạt động. / Update an email config; new recipients must be verified before activation.
| Name | Type | Req | Description |
|---|---|---|---|
| config_id | string | yes | UUID cấu hình email |
| events | array | – | – |
| is_active | boolean | – | – |
| name | string | – | – |
| recipients | array | – | – |
| virtual_account_id | – | – | UUID VA; null để bỏ giới hạn VA |
No output schema declared.
No examples provided.
monapay_update_webhook Sửa cấu hình webhook ~103
Cập nhật webhook (URL, secret, bật/tắt). / Update a webhook config.
| Name | Type | Req | Description |
|---|---|---|---|
| api_key_name | string | – | – |
| auth_type | string | – | – |
| config_id | string | yes | – |
| is_active | boolean | – | – |
| name | string | – | – |
| payload_format | string | – | – |
| secret_key | string | – | – |
| virtual_account_id | string | – | – |
| webhook_url | string | – | – |
No output schema declared.
No examples provided.
monapay_update_zalo_group Sửa nhóm Zalo ~141
Sửa cấu hình nhóm có bot Gấu Mona; group_id lấy từ MONA Account/PMS và template dùng text thuần vì Zalo không parse Markdown.
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | – | – |
| friendly_name | string | – | – |
| group_id | string | – | group_id gồm 10–25 chữ số, lấy từ MONA Account/PMS |
| id | string | yes | ID cấu hình nhóm Zalo do MONA Pay trả về (UUIDv6) |
| is_active | boolean | – | – |
| message_template | string | – | Template text thuần, không dùng Markdown |
| virtual_account_id | string | – | – |
No output schema declared.
No examples provided.
monapay_verify_email Xác minh địa chỉ nhận email ~105
Xác minh một người nhận bằng đúng mã 6 số người dùng đọc từ hộp thư; phải hỏi người dùng và không tự đoán mã. / Verify a recipient with the exact 6-digit code supplied by the user; never guess it.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | Mã 6 số do người dùng cung cấp |
| config_id | string | yes | UUID cấu hình email |
| string | yes | Địa chỉ đang chờ xác minh |
No output schema declared.
No examples provided.
monapay_verify_signature Kiểm chữ ký webhook (offline) ~92
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.
| Name | Type | Req | Description |
|---|---|---|---|
| raw_body | string | yes | – |
| secret | string | yes | – |
| signature | string | yes | – |
| skip_time_check | boolean | – | – |
| timestamp | string | yes | – |
| tolerance_sec | integer | – | – |
No output schema declared.
No examples provided.
monapay_webhook_logs Lịch sử gửi webhook ~76
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.
| Name | Type | Req | Description |
|---|---|---|---|
| from_date | string | – | YYYY-MM-DD |
| limit | integer | – | – |
| page | integer | – | – |
| status | string | – | – |
| to_date | string | – | – |
No output schema declared.
No examples provided.
monapay_webhook_stats Thống kê webhook ~30
Tỷ lệ thành công, P95, phân loại lỗi. / Webhook delivery stats.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_whoami Kiểm tra kết nối MONA Pay ~40
Xác nhận client credentials đang hoạt động, trả tên tài khoản và gói hiện tại. / Verify connection and return account name and plan.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
monapay_zalo_group_logs Lịch sử gửi nhóm Zalo ~46
Tra lịch sử gửi vào nhóm Zalo, lọc trạng thái thành công hoặc thất bại.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| status | string | – | – |
No output schema declared.
No examples provided.
What is the vn.monapay/monapay-mcp server?
vn.monapay/monapay-mcp is listed in the public MCP registry as vn.monapay/monapay-mcp. MONA Pay for AI agents: create VietQR, check bank transfers, webhooks & HMAC. Vietnam bank API, VND. This page covers its npm package (monapay-mcp).
Is the vn.monapay/monapay-mcp server safe to use?
vn.monapay/monapay-mcp scores 69 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 26 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the vn.monapay/monapay-mcp server expose?
vn.monapay/monapay-mcp exposes 50 tools: monapay_me, monapay_whoami, monapay_list_bank_accounts, monapay_list_virtual_accounts, monapay_link_bank_start, and 45 more. Their descriptions and schemas cost roughly 4,394 tokens of context every time the server is loaded.
Is the vn.monapay/monapay-mcp server still maintained?
vn.monapay/monapay-mcp is still listed as active in the MCP registry. We last reached this channel on 26 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the vn.monapay/monapay-mcp server under?
vn.monapay/monapay-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.