Vnpay

FreeNot checked

MCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMA

by theYahia

GitHub Embed

About

MCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMAC-SHA512 signing.

README

MCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMAC-SHA512 signing.

Tools (8)

Tool	Description
`create_payment_url`	Generate a VNPay payment URL
`query_transaction`	Query transaction status
`refund`	Refund a transaction
`get_bank_list`	Get supported bank list
`create_token`	Create a card token
`pay_with_token`	Pay using stored token
`query_token`	Query token information
`verify_ipn`	Verify IPN callback signature

Quick Start

{
  "mcpServers": {
    "vnpay": {
      "command": "npx",
      "args": ["-y", "@theyahia/vnpay-mcp"],
      "env": {
        "VNPAY_TMN_CODE": "<YOUR_TMN_CODE>",
        "VNPAY_HASH_SECRET": "<YOUR_HASH_SECRET>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`VNPAY_TMN_CODE`	Yes	Terminal code from VNPay
`VNPAY_HASH_SECRET`	Yes	Hash secret for HMAC-SHA512 signing
`VNPAY_PRODUCTION`	No	Set to "true" for production

Demo Prompts

"Create a VNPay payment URL for 100,000 VND"
"Query transaction status for order vnp-123"
"Get list of supported Vietnamese banks"
"Verify this IPN callback: vnp_TxnRef=..."

License

MIT

from github.com/theYahia/vnpay-mcp

Install Vnpay in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install vnpay-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add vnpay-mcp -- npx -y @theyahia/vnpay-mcp

FAQ

Is Vnpay MCP free?

Yes, Vnpay MCP is free — one-click install via Unyly at no cost.

Does Vnpay need an API key?

No, Vnpay runs without API keys or environment variables.

Is Vnpay hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Vnpay in Claude Desktop, Claude Code or Cursor?

Open Vnpay on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Stripe

Payments, customers, subscriptions

by Stripe

malamutemayhem/unclick-agent-native-endpoints

110+ tools for AI agents spanning social media, finance, gaming, music, AU-specific services, and utilities. Zero-config local tools plus platform connectors. n

by malamutemayhem

whiteknightonhorse/APIbase

Unified API hub for AI agents with 56+ tools across travel (Amadeus, Sabre), prediction markets (Polymarket), crypto, and weather. Pay-per-call via x402 micropa

by whiteknightonhorse

trackerfitness729-jpg/sitelauncher-mcp-server

Deploy live HTTPS websites in seconds. Instant subdomains ($1 USDC) or custom .xyz domains ($10 USDC) on Base chain. Templates for crypto tokens and AI agent pr

by trackerfitness729-jpg

Compare Vnpay with

VnpayvsStripe Vnpayvsmalamutemayhem/unclick-agent-native-endpoints Vnpayvswhiteknightonhorse/APIbase Vnpayvstrackerfitness729-jpg/sitelauncher-mcp-server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All finance MCPs