Vietnam Payments MCP — let AI agents accept MoMo payments in Vietnam

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

{
  "mcpServers": {
    "vietnam-payments": {
      "type": "http",
      "url": "https://mcp-vn.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

Deploy with Vercel

git clone https://github.com/junter1989k-ai/vietnam-payments-mcp && cd vietnam-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-vn.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/vietnam-payments-mcp · Part of a 10-country family: Taiwan · Japan · Korea · Indonesia · India · Brazil · Philippines · Thailand · Malaysia

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Vietnam:

📱 MoMo wallet QR — the biggest e-wallet in Vietnam
💳 ATM cards / credit cards on the MoMo hosted page
🎁 Zero-setup demo — no credentials needed to try it (public MoMo sandbox, test money only)
🔍 Payment status check — pull-based, no webhook needed; no confirm step

v0.2 aggregates two Vietnamese gateways: MoMo (default; zero-setup sandbox demo) and VNPay (signed HMAC-SHA512 redirect URLs; send x-vnpay-tmn-code + x-vnpay-hash-secret and it is auto-selected).

⚖️ Stateless translation layer: funds always flow buyer → MoMo → merchant directly. This server never holds, moves, or stores funds or credentials — no database at all. Requests are signed per-call with HMAC-SHA256 in memory.

Quick start

MCP endpoint: https://mcp-vn.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Try it with no headers at all — the public MoMo sandbox demo works immediately. For real payments:

Header	Value
`x-momo-partner-code` / `x-momo-access-key` / `x-momo-secret-key`	Your MoMo business credentials (from business.momo.vn).
`x-momo-mode`	`test` to use the MoMo test host with your own sandbox merchant (optional; default production).

Tools

Tool	What it does
`create_payment_link`	Create a VND payment (1,000–50,000,000₫). Returns the MoMo hosted `payment_url` + `order_id`.
`query_payment_status`	Check by `order_id`: PAID / PENDING / FAILED.
`refund_payment`	Refund a paid MoMo payment (full or partial). By `order_id` (looks up the transId; full refund if `amount` omitted) or `trans_id` + `amount`. MoMo only.

Develop

node test/serve.js      # local server (http://localhost:3220/mcp)
node test/e2e.js        # e2e incl. a REAL sandbox create+query against MoMo test host

Zero runtime dependencies; Node ≥ 18. MIT license.

app.wishpool/vietnam-payments-mcp