dsh-vn-biz

When an AI agent handles Vietnam-specific business tasks—reading large VND amounts in words, generating VietQR transfer QR codes, or looking up registered companies by tax ID—these are exactly the spots where LLMs tend to fail. Misspelled number groups, scrambled QR parameter order, or hallucinated company names are real, recurring risks. dsh-vn-biz wraps these three operations into deterministic tools so the agent calls a fixed algorithm instead of reasoning its way to an answer.

Each tool handles one job: amount_to_words converts a non-negative integer into Vietnamese spoken form using a fixed algorithm that correctly handles edge cases like mot, lam, linh and multiple zero groups in the middle; vietqr_quicklink builds a compliant VietQR image URL with the correct parameter sequence and encoding so the resulting QR code is always scannable; tax_code_lookup queries api.vietqr.io in real time, returning verified data when found and a clear not-found message otherwise, eliminating hallucination.

No API key configuration is required; after installation, users simply ask in natural language and the agent routes to the right tool automatically. It suits developers working on Vietnam-based payments, finance, or compliance workflows, or anyone who needs an agent to produce locally correct document formats. Released under the MIT license for unrestricted integration.