# phuocdu/agentpay-vn [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/phuocdu/agentpay-vn  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/phuocdu-agentpay-vn

## Description
VietQR payments for AI agents in Vietnam. Agents generate a VietQR code, send it to the user, and auto-confirm settlement from the bank feed. Non-custodial — money flows directly to the merchant's bank account, never held by the platform. pip install agentpay-vn, ships an MCP server for Claude Desktop/Code.

## Tools
Capabilities this server exposes over MCP:

- **create_payment_request** — Generate a VietQR code for a given amount
- **check_payment** — Get current status of a payment request
- **await_settlement** — Poll until payment arrives or timeout (max 600 s)
- **list_recent_payments** — List last N settled transactions

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "agentpay-vn": {
    "command": "uvx",
    "args": ["agentpay-vn"],
    "env": {
      "AGENTPAY_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `AGENTPAY_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/phuocdu-agentpay-vn/readme_