Agentpay Vn

What phuocdu/agentpay-vn MCP server does

The phuocdu/agentpay-vn MCP server exposes VietQR payment operations to MCP-compatible agents. An agent can create a payment request for a specified amount, receive a QR image or checkout link, and send that payment information to a user in a conversation. After the user pays, the service checks the connected bank feed and updates the request when it finds a matching transaction.

The payment flow is non-custodial. The QR code directs money to the merchant's bank account, while AgentPay reads transaction data to identify settlement. The platform does not hold the payment funds.

How it works

The agent first calls create_payment_request, which creates a payment request and returns identifiers and checkout information. The user scans the VietQR code or opens the checkout page and completes the bank transfer. The agent can then call check_payment for the current state or use await_settlement to poll until settlement or timeout.

await_settlement supports waits of up to 600 seconds. Once the payment is confirmed, an application can release an order, unlock content, or provide another paid service. list_recent_payments provides a view of the latest settled transactions for reconciliation.

The phuocdu/agentpay-vn MCP server is a thin client over the AgentPay API. Authentication uses an AGENTPAY_API_KEY value, with separate test and live key formats documented by the project. The API base URL can also be configured through AGENTPAY_BASE_URL.

Setup and configuration

Install the Python package with pip install agentpay-vn. The package includes the agentpay-mcp console command and can also be launched with python -m agentpay.mcp_server.

For Claude Desktop or Claude Code, add an MCP server entry that runs the console command or Python module and supplies the API key. The documented configuration also sets AGENTPAY_BASE_URL to the service's versioned API endpoint. Test keys use the sandbox, while live keys access real payment processing.

The project describes the deployment as early access and self-hosted. Live operation requires an AgentPay service, a SePay bank feed account, and the surrounding backend infrastructure. Self-hosting documentation lists Docker Swarm, MongoDB, and Nginx requirements.

Tools and capabilities

• create_payment_request: Create a VietQR request for a specified amount.
• check_payment: Retrieve the current status of a payment request.
• await_settlement: Wait for a matching bank transfer or stop at the configured timeout.
• list_recent_payments: List recent settled transactions.

The underlying API supports sandbox settlement simulation for testing. It also supports idempotency keys for avoiding duplicate payment requests, although those are API behavior rather than separate MCP tools.

Limitations and notes

The service is intended for payments in Vietnam using VietQR and a connected bank transaction feed. Settlement depends on the bank-feed integration finding a matching transfer; generating a QR code alone does not confirm payment. Applications should wait for a settled status before delivering goods or services.

The MCP server requires an API key. The documented free tier allows 50 settled payments per month and 120 requests per minute. The project is licensed under MIT and identifies its current status as early access / self-hosted.