momo-vn-mcp

MCP server for MoMo payment gateway (Vietnam). Supports wallet payments, QR codes, refunds, recurring payments, and HMAC-SHA256 signed API calls.

Tools (8)

Tool	Description
`create_payment`	Create a MoMo payment request
`query_status`	Query payment status
`refund`	Refund a completed payment
`confirm`	Confirm/capture authorized payment
`create_recurring`	Set up recurring wallet payment
`get_token_info`	Get linked wallet token info
`create_qr`	Create a QR code payment
`get_qr_status`	Check QR payment status

Quick Start

{
  "mcpServers": {
    "momo-vn": {
      "command": "npx",
      "args": ["-y", "@theyahia/momo-vn-mcp"],
      "env": {
        "MOMO_PARTNER_CODE": "<PARTNER_CODE>",
        "MOMO_ACCESS_KEY": "<ACCESS_KEY>",
        "MOMO_SECRET_KEY": "<SECRET_KEY>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`MOMO_PARTNER_CODE`	Yes	Partner code from MoMo
`MOMO_ACCESS_KEY`	Yes	Access key from MoMo
`MOMO_SECRET_KEY`	Yes	Secret key for HMAC signing
`MOMO_PRODUCTION`	No	Set to "true" for production

Demo Prompts

"Create a MoMo payment of 50,000 VND"
"Check status of order momo-123"
"Refund 25,000 VND from transaction t1"
"Generate a QR code for 100,000 VND"

License

MIT

@theyahia/momo-vn-mcp

Quick Install