# Thuế hộ kinh doanh Việt Nam 2026

> Thuế hộ kinh doanh Việt Nam 2026 is an MCP server for accounting and tax. MCP server for Vietnamese household business tax and personal income tax estimates. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://www.nganhangquangngai.com/openapi.json
- **MCP Registry name:** com.nganhangquangngai/thue-hkd
- **Categories:** [accounting and tax](https://ai-powered.com/categories/accounting-and-tax)
- **Listing updated:** 2026-11-19

## About

The README-free registry entry and the service's OpenAPI document describe a set of Vietnamese tax and loan calculators exposed over MCP at a streamable HTTP endpoint. The service estimates value-added tax and personal income tax for household businesses using revenue groups, with legal citations attached to each result, so a user can see which decrees and articles a figure rests on.

Beyond household business tax, it covers monthly withholding and annual finalization of salary income tax, including dependents, insurance and capped medical and education deductions. It also offers simple and installment loan calculations where the interest rate is supplied by the caller. Results include warnings and a list of items it could not verify, which it leaves out of the calculation.

The API is publicly accessible without a key. The OpenAPI description states that outputs are estimates and do not replace guidance from the tax authority, so it suits accountants, small business owners and developers building tax tools for Vietnam.

## Features

- **Household business tax estimate:** Calculates VAT and personal income tax for a household business from annual revenue by business group.
- **Salary income tax finalization:** Computes annual personal income tax on wages with insurance, dependent and deduction inputs.
- **Monthly withholding calculation:** Estimates the tax withheld from a single month's taxable salary income.
- **Legal citations per result:** Attaches the decrees and articles used to each calculated figure.
- **Loan and installment schedules:** Computes simple interest on deposits and amortization schedules for loans at a caller-supplied rate.
- **Public API without a key:** The same functions are available as a REST API and over MCP without authentication.

## Good for

- Estimating annual VAT and personal income tax for a Vietnamese household business
- Checking whether revenue crosses the e-invoice threshold or a tax group boundary
- Preparing an annual salary tax finalization with dependents and deductions
- Building a tax assistant that cites the legal basis for each figure
- Producing a loan repayment schedule for a small business purchase

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http thue-hkd https://www.nganhangquangngai.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.nganhangquangngai.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "thue-hkd": {
      "url": "https://www.nganhangquangngai.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "thue-hkd": {
      "type": "http",
      "url": "https://www.nganhangquangngai.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "thue-hkd": {
      "serverUrl": "https://www.nganhangquangngai.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://www.nganhangquangngai.com/mcp
```

Enter a Name (for example "Thuế hộ kinh doanh Việt Nam 2026"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "thue-hkd": {
      "type": "http",
      "url": "https://www.nganhangquangngai.com/mcp"
    }
  }
}
```

## Tools

- `tinh_thue_hkd`: Ước lượng thuế GTGT và TNCN một năm của hộ kinh doanh Việt Nam. Tiền tính bằng đồng. nganh: danh sách {nhom, doanh_thu}; nhom thuộc: hang_hoa, dich_vu, san_xuat_van_tai_an_uong, cho_thue_tai_san_khac, dai_ly_bh_xs_dacap, noi_dung_so, khac, cho_thue_bat_dong_san. chi_phi: chi phí cả năm (đồng), bắt buộc khi doanh thu trên 3 tỷ. Estimate annual VAT and personal income tax of a Vietnamese household b
- `tra_nguong_doanh_thu`: Tra nhóm hộ kinh doanh và nghĩa vụ thuế theo doanh thu cả năm (đồng): miễn thuế hay không, phương pháp tính, hóa đơn điện tử, giảm 30% TNCN. Look up the household-business tier and tax duties for an annual revenue in VND. Kết quả kèm trường can_cu (văn bản pháp luật) và chua_xac_minh (khoản chưa xác minh, trả null thay vì đoán) và luu_y. Results include can_cu, chua_xac_minh and a disclaimer.
- `tinh_lai_tiet_kiem`: Tính lãi tiết kiệm (lãi đơn). so_tien: gốc (đồng); lai_suat_nam_pct: lãi suất %/năm do người dùng cung cấp; ky_han_thang: kỳ hạn (tháng); cach: cuoi_ky (nhận cả gốc lẫn lãi khi đáo hạn) hoặc hang_thang (nhận lãi mỗi tháng); so_ngay: tuỳ chọn, tính theo ngày/365. Compute simple-interest savings return (amount in VND, rate in %/year, term in months). Kết quả kèm trường can_cu (văn bản pháp luật) và 
- `tinh_tra_gop`: Lập lịch trả góp từng kỳ (gốc, lãi, tổng, còn lại). so_tien: số vay (đồng); lai_suat_nam_pct: lãi suất %/năm do người dùng cung cấp; so_thang: số tháng (tối đa 1200); kieu: du_no_giam_dan (gốc chia đều, lãi trên dư nợ) hoặc tra_deu (niên kim, mỗi kỳ trả cố định). Build a loan repayment schedule (amount in VND, rate in %/year, term in months). Kết quả kèm trường can_cu (văn bản pháp luật) và chua_x
- `tinh_thue_tncn_nam`: Tính thuế TNCN tiền lương, tiền công cả năm (quyết toán) của cá nhân cư trú, từ kỳ tính thuế 2026 (Luật 109/2025/QH15, Nghị định 253/2026/NĐ-CP). Tiền tính bằng đồng/năm. thu_nhap_chiu_thue_nam: tổng thu nhập chịu thuế cả năm; bao_hiem_bat_buoc_nam: bảo hiểm được trừ; nguoi_phu_thuoc_thang: tổng số tháng-người phụ thuộc trong năm (2 người x 12 tháng = 24); so_thang_giam_tru_ban_than: 0 đến 12 (mặc
- `tinh_thue_tncn_thang`: Tính thuế TNCN tiền lương tạm khấu trừ một tháng theo biểu lũy tiến (cá nhân cư trú, hợp đồng từ 03 tháng). Tiền tính bằng đồng/tháng. thu_nhap_chiu_thue_thang: thu nhập chịu thuế tháng; bao_hiem_bat_buoc_thang: bảo hiểm được trừ trong tháng; so_nguoi_phu_thuoc: số người phụ thuộc (mỗi người 6,2 triệu/tháng). Không gồm y tế, giáo dục, từ thiện. Compute monthly salary income tax withholding (VND pe

## FAQ

### Does the service require an API key?

The OpenAPI description states that the public API needs no key.

### Are the results official tax determinations?

No. The description says results are estimates based on the cited legal texts and do not replace guidance from the tax authority.

### Which tax year is covered?

The tax calculations default to 2026, and the salary finalization endpoint accepts 2026 or 2027.

### Does the server also cover fonts?

The OpenAPI description mentions two Vietnamese font lookup tools available at a separate /font/mcp endpoint, not on the tax server.

### How do I add Thuế hộ kinh doanh Việt Nam 2026 to Claude Code?

Run this command in your terminal: claude mcp add --transport http thue-hkd https://www.nganhangquangngai.com/mcp

### What are the best alternatives to Thuế hộ kinh doanh Việt Nam 2026?

The closest alternatives to Thuế hộ kinh doanh Việt Nam 2026 are Kalkulator B2B, TaxCheck AU: Australian Tax Calculators, US Business Calendar MCP, Site and TaxTools Network Tax Facts.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Kalkulator B2B](https://ai-powered.com/mcp/kalkulator-b2b): Kalkulator B2B is a free MCP server for accounting and tax.
- [TaxCheck AU: Australian Tax Calculators](https://ai-powered.com/mcp/taxcheck-au-australian-tax-calculators): TaxCheck AU: Australian Tax Calculators is a free MCP server for accounting and tax.
- [US Business Calendar MCP](https://ai-powered.com/mcp/us-business-calendar-mcp): US Business Calendar MCP is a freemium MCP server for productivity.
- [Site](https://ai-powered.com/mcp/site-mwerieqa): Site is a paid MCP server for accounting and tax.
- [TaxTools Network Tax Facts](https://ai-powered.com/mcp/taxtools-network-tax-facts): TaxTools Network Tax Facts is a free MCP server for accounting and tax.
- [Site](https://ai-powered.com/mcp/site-mwerj3t7): Site is a freemium MCP server for accounting and tax.
- [Openaccountants MCP](https://ai-powered.com/mcp/openaccountants-mcp): Openaccountants MCP is an open-source MCP server for accounting and tax.
- [Nationale Boekhoudmaatschappij](https://ai-powered.com/mcp/nationale-boekhoudmaatschappij): Nationale Boekhoudmaatschappij is an MCP server for accounting and tax.

---
Source: https://ai-powered.com/mcp/thue-ho-kinh-doanh-viet-nam-2026
