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.