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