🇻🇳 Vietnam Invoice MCP live

AI agents can now create, publish and query a Vietnamese e-invoice (hóa đơn điện tử) through MISA meInvoice. Electronic invoices have been mandatory nationwide since 1 July 2022 — this remote MCP server wraps the MISA API: create_invoice builds the invoice and computes the VAT in VND, publish_invoice forwards your merchant-signed XML to issue the official number, and query_invoice reports the tax-authority status. It only wraps the API calls: your digital signature (USB Token / chữ ký số) stays merchant-side.

Connect

{
  "mcpServers": {
    "vietnam-invoice": {
      "type": "http",
      "url": "https://inv-vn.wishpool.app/mcp",
      "headers": {
        "x-meinvoice-token": "your-misa-meinvoice-token",
        "x-meinvoice-taxcode": "your-company-tax-code",
        "x-meinvoice-env": "prod"
      }
    }
  }
}

Get your MISA meInvoice access token from the MISA token endpoint (with your app credentials). Omit x-meinvoice-env to stay in the test sandbox at testapi.meinvoice.vn (no fiscal effect); prod = production at api.meinvoice.vn. Your USB Token and private key never leave your side — this server never sees them.

How it works

• Create → sign → publish: create_invoice takes seller, buyer and line items, computes the Vietnamese VAT (thuế GTGT) in VND (whole đồng), and POSTs to MISA's createinvoice endpoint — MISA returns an unsigned invoice XML plus a transaction_id. You sign that XML on your side with your USB Token via the MISA local signing service. publish_invoice then forwards the signed XML and MISA issues the official inv_no / inv_code.
• VAT rates: 10% (standard), 8% (temporary reduced), 5% (essentials), 0% (exports) — you set the rate per line; the tax classification is your decision.
• Có mã / không mã: set withCode=true for invoices with a tax-authority code (có mã), default is without code (không mã).
• Status: query_invoice returns send_tax_status (0 not sent, 1 sent, 2 accepted, 3 rejected, 4 error) and the publish status.

Why it is safe

• Stateless: no database — your MISA token and tax code travel per-request in headers and are never stored.
• Signing stays with you: the digital signature (chữ ký số) on your USB Token / HSM is applied merchant-side; a compromise here cannot forge or issue your invoices.
• Owner policy guardrails: x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools — set by the human owner in client config; the agent cannot relax them. The cap applies to the invoice grand total (TotalAmount, VND) computed at create time.

Weak-model friendly

Credentials taken from headers (never in the body); VAT computed for you in integer VND; tax-authority status enums (not sent / sent / accepted / rejected) spelled out in every tool description; MISA responses passed through with numbered next_steps; every error teaches the fix (both credential headers, required invSeries, sign-then-publish flow, env).

Sister servers

Invoices: Malaysia MyInvois inv-my · Saudi ZATCA inv-sa · Mexico CFDI 4.0 inv-mx · Poland KSeF inv-pl · Chile DTE inv-cl · Brazil NF-e inv-br · Peru CPE inv-pe · India GST inv-in. Local payments in 81 countries: mcp.wishpool.app · Logistics: logi.wishpool.app. One family, same stateless BYO pattern.