Skip to content
Agentmart
Submit a tool

AgentPay VN

Let AI agents collect VietQR payments — generate a QR and auto-confirm settlement.

Connector by phuocdu · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 1
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/phuocdu-agentpay-vn

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Let AI agents collect VietQR payments — generate a QR and auto-confirm settlement.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
2 read · 2 write · 0 delete · 1 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 5

Read from the source code; the running server may list different tools.

Read 2 · Look things up without changing anything.

  • check_payment
  • list_recent_payments

Write 2 · Create, change, send or run things.

  • create_payment_request
  • register_sandbox

Not yet classified 1 · We could not tell from the name and description.

  • await_settlement

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • AGENTPAY_API_KEY

Other settings (environment variables or headers).

  • AGENTPAY_BASE_URL

Network hosts it talks to 5

  • agentpay.servicesai.vn · found in code
  • api.agentpay.vn · found in code
  • github.com · found in code
  • glama.ai · found in code
  • sono.servicesai.vn · found in code

Tools (5)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • await_settlement

    Wait for a payment request to be settled (polls on behalf of the agent). Polls every 5 seconds until status != pending or the timeout is reached (maximum 600 s). Call this after sending the QR to the payer. If the timeout expires while still pending, ask the user whether to keep waiting or cancel. Args: payment_request_id: The ``id`` returned by ``create_payment_request``. timeout_seconds: How long to wait in seconds (10–600, default 180).

  • check_payment

    Check the current status of a payment request. Returns: One of: pending | settled | underpaid | expired | cancelled, along with the amount received so far. Only treat a payment as complete when status=settled.

  • create_payment_request

    Create a VietQR payment request. Args: amount: Amount in VND, minimum 1 000. description: Short description for the payer (e.g. "Order #123 — 2 kg coffee"). ttl_minutes: QR validity window in minutes (5–1 440, default 60). metadata_note: Internal note from the agent (order id, conversation id, etc.) — echoed back in webhook events. Returns: id, pay_code, QR image URL, and checkout page URL. Send ``qr_image_url`` or ``checkout_url`` to the payer, then call ``await_settlement(id)`` to wait for the money to arrive.

  • list_recent_payments

    List the most recently settled transactions (quick reconciliation). Args: limit: Number of transactions to return (1–50, default 10).

  • register_sandbox

    Get a FREE sandbox API key (ap_test_*) instantly — call this FIRST when AGENTPAY_API_KEY is not set. No account, no human approval, no real money. The key lives 7 days; call again with the same email to renew it and keep the same sandbox org. The new key is applied to this MCP session automatically, so create_payment_request works immediately afterwards. Args: email: Optional — reusing the same email keeps the same org and its data. shop_name: Display name for the sandbox merchant.

Signals

Stars
1
Forks
0
Open issues
1
Weekly downloads
167
Last commit
Oct 20, 2026 (9 days ago)
Last release
Oct 21, 2026 (7 days ago)
Last package publish
Oct 20, 2026 (9 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.phuocdu/agentpay-vn
Version
1.1.0
Auth
API key
Packages
pypi agentpay-vn
License
MIT
Repository
github.com/phuocdu/agentpay-vn
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

AgentPay VN MCP server. Agent Mart. https://agentmart.dev/connectors/phuocdu-agentpay-vn (last updated 2026-10-24)