Monapay MCP
Create VietQR codes, check bank transfers and manage webhooks for MONA Pay from an agent
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.6.2
- Listing updated
- 2 days ago
About Monapay MCP
Monapay MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Set-up is the hard part of bank-transfer payments in Vietnam, and this server automates much of it from a coding agent. It can link an ACB bank account (two OTP steps), create a virtual account, turn on incoming-transfer notifications, and then create hosted checkout links or dynamic VietQR codes per order.
For testing there is a sandbox tool that fakes an incoming transaction, firing webhooks and Telegram, email and Zalo notifications as for a real one. Webhooks can use no auth, an API key or HMAC-SHA256, which is recommended, with test sends, delivery logs and success statistics.
It needs a MONA Pay client_id and client_secret created in the dashboard. MONA Pay lists a free tier of 500 transactions a month with no percentage fee.
Install
Run in a terminal
claude mcp add monapay-mcp --env MONAPAY_CLIENT_ID='<MONAPAY_CLIENT_ID>' --env MONAPAY_CLIENT_SECRET='<MONAPAY_CLIENT_SECRET>' -- npx -y monapay-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
],
"env": {
"MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
"MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
],
"env": {
"MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
"MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"monapay-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"monapay-mcp"
],
"env": {
"MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
"MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
],
"env": {
"MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
"MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"monapay-mcp": {
"command": "npx",
"args": [
"-y",
"monapay-mcp"
],
"env": {
"MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
"MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
}
}
}
}Configuration
MONAPAY_CLIENT_IDMONA Pay API key client_id (create in dashboard my.monapay.vn).RequiredMONAPAY_CLIENT_SECRETMONA Pay API key client_secret (shown once). Needed for write actions (create QR, webhooks).RequiredMONAPAY_BASE_URLOptional API base URL (default production).
Tools this server provides (28)
Taken from the project documentation; the running server may differ.
- monapay_quickstart
- Check account state and return next steps.
- monapay_whoami
- Verify the connection and return account name and plan.
- monapay_me
- Profile of the logged-in account.
- monapay_link_bank_start
- Start linking an ACB account.
- monapay_link_bank_verify_otp
- Verify the first OTP.
- monapay_notification_register
- Turn on incoming-transfer notifications.
- monapay_notification_verify_otp
- Verify the second OTP.
- monapay_list_bank_accounts
- List linked bank accounts.
- monapay_list_virtual_accounts
- List virtual accounts.
- monapay_get_payment_profile
- View the checkout profile.
- monapay_set_payment_profile
- Set the checkout profile.
- monapay_create_checkout
- Create a hosted checkout session.
- monapay_get_checkout
- Inspect a checkout.
- monapay_list_checkouts
- List checkouts.
- monapay_cancel_checkout
- Cancel a checkout.
- monapay_create_qr
- Create a dynamic VietQR.
- monapay_cancel_qr
- Cancel a QR.
- monapay_list_transactions
- List incoming transactions.
- monapay_get_transaction
- Find one transaction.
- monapay_get_transactions_summary
- Totals and daily data for a range.
- monapay_sandbox_transaction
- Create a fake incoming transaction.
- monapay_list_webhooks
- List webhooks.
- monapay_create_webhook
- Create a webhook.
- monapay_update_webhook
- Update a webhook.
- monapay_delete_webhook
- Delete a webhook.
- monapay_test_webhook
- Send a dummy webhook.
- monapay_webhook_logs
- Per-delivery history.
- monapay_webhook_stats
- Success rate and P95.
What it does
- Bank linking
- Links an ACB account and creates a virtual account.
- Checkout and VietQR
- Creates checkout sessions and dynamic QR codes.
- Transaction lookup
- Lists and summarises incoming transfers.
- Webhook management
- Creates, tests and monitors signed webhooks.
- Sandbox transactions
- Simulates incoming payments.
- Group notifications
- Configures email and Zalo notifications.
Good for
- Wire up payment confirmation for a new shop
- Create a QR code for a specific order
- Reconcile incoming transfers for a date range
- Test a webhook without a real payment
Pricing
Freemium
500 transactions a month free; paid tiers not published
Prices change. Check monapay.vn before you buy.
Monapay MCP FAQ
What credentials are needed?
MONAPAY_CLIENT_ID and MONAPAY_CLIENT_SECRET from the dashboard.
Is there a free tier?
The site lists 500 free transactions a month and no percentage fee.
How are webhooks secured?
HMAC-SHA256 is recommended; the SDKs verify signatures and reject timestamps beyond 300 seconds.
What runs it?
npx -y monapay-mcp over stdio, Node.js 18 or later.
Is Monapay MCP free?
Monapay MCP has a free plan, with paid plans for more usage or features.
How do I add Monapay MCP to Claude Code?
Run this command in your terminal: claude mcp add monapay-mcp --env MONAPAY_CLIENT_ID='<MONAPAY_CLIENT_ID>' --env MONAPAY_CLIENT_SECRET='<MONAPAY_CLIENT_SECRET>' -- npx -y monapay-mcp
What are the best alternatives to Monapay MCP?
The closest alternatives to Monapay MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Monapay MCP

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government