Content
# Vietnamese Law MCP Server
**The Cổng thông tin pháp luật (thuvienphapluat.vn) alternative for the AI age.**
[](https://www.npmjs.com/package/@ansvar/vietnamese-law-mcp)
[](https://registry.modelcontextprotocol.io)
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/Ansvar-Systems/vietnamese-law-mcp)
[](https://github.com/Ansvar-Systems/vietnamese-law-mcp/actions/workflows/ci.yml)
[](https://github.com/Ansvar-Systems/vietnamese-law-mcp/actions/workflows/check-updates.yml)
[](docs/INTERNATIONAL_ALIGNMENT.md)
[](docs/INTERNATIONAL_ALIGNMENT.md)
Query **93 Vietnamese statutes** -- from the Luật An ninh mạng (Cybersecurity Law) and Nghị định về bảo vệ dữ liệu cá nhân to Bộ luật Hình sự, Bộ luật Dân sự, Luật Giao dịch điện tử, and more -- directly from Claude, Cursor, or any MCP-compatible client.
If you're building legal tech, compliance tools, or doing Vietnamese legal research, this is your verified reference database.
Built by [Ansvar Systems](https://ansvar.eu) -- Stockholm, Sweden
---
## Why This Exists
Vietnamese legal research means navigating thuvienphapluat.vn and luatvietnam.vn, parsing Bộ luật, Luật, Nghị định, Thông tư, and Quyết định across multiple ministries, and manually tracking amendments from the National Assembly and Government. Whether you're:
- A **lawyer** validating citations in a brief or contract
- A **compliance officer** checking cybersecurity law obligations or personal data protection requirements
- A **legal tech developer** building tools on Vietnamese law
- A **researcher** tracing how legislation flows from National Assembly through ministerial decrees
...you shouldn't need dozens of browser tabs and manual cross-referencing. Ask Claude. Get the exact provision. With context.
This MCP server makes Vietnamese law **searchable, cross-referenceable, and AI-readable**.
---
## Quick Start
### Use Remotely (No Install Needed)
> Connect directly to the hosted version -- zero dependencies, nothing to install.
**Endpoint:** `https://mcp.ansvar.eu/law-vn/mcp`
| Client | How to Connect |
|--------|---------------|
| **Claude.ai** | Settings > Connectors > Add Integration > paste URL |
| **Claude Code** | `claude mcp add vietnamese-law --transport http https://mcp.ansvar.eu/law-vn/mcp` |
| **Claude Desktop** | Add to config (see below) |
| **GitHub Copilot** | Add to VS Code settings (see below) |
**Claude Desktop** -- add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"vietnamese-law": {
"type": "url",
"url": "https://mcp.ansvar.eu/law-vn/mcp"
}
}
}
```
**GitHub Copilot** -- add to VS Code `settings.json`:
```json
{
"github.copilot.chat.mcp.servers": {
"vietnamese-law": {
"type": "http",
"url": "https://mcp.ansvar.eu/law-vn/mcp"
}
}
}
```
### Use Locally (npm)
```bash
npx @ansvar/vietnamese-law-mcp
```
**Claude Desktop** -- add to `claude_desktop_config.json`:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"vietnamese-law": {
"command": "npx",
"args": ["-y", "@ansvar/vietnamese-law-mcp"]
}
}
}
```
**Cursor / VS Code:**
```json
{
"mcp.servers": {
"vietnamese-law": {
"command": "npx",
"args": ["-y", "@ansvar/vietnamese-law-mcp"]
}
}
}
```
## Example Queries
Once connected, just ask naturally -- in Vietnamese or English:
- *"Nghị định 13/2023/NĐ-CP quy định gì về bảo vệ dữ liệu cá nhân?"*
- *"Tìm kiếm các quy định về 'bảo vệ dữ liệu cá nhân' trong pháp luật Việt Nam"*
- *"Luật An ninh mạng 2018 có còn hiệu lực không?"*
- *"Bộ luật Hình sự quy định gì về tội vi phạm quy định về mạng máy tính?"*
- *"Tìm các điều khoản về giao dịch điện tử trong Luật Giao dịch điện tử 2023"*
- *"Luật Doanh nghiệp 2020 quy định gì về trách nhiệm của giám đốc?"*
- *"What does Vietnamese cybersecurity law say about data localization?"*
- *"Find Vietnamese consumer protection provisions"*
- *"Which Vietnamese laws apply to cross-border data transfers?"*
---
## What's Included
| Category | Count | Details |
|----------|-------|---------|
| **Statutes** | 93 statutes | Curated Vietnamese legislation (key compliance laws) |
| **Provisions** | 3,226 sections | Full-text searchable with FTS5 |
| **Database Size** | ~14 MB | Optimized SQLite, portable |
| **Daily Updates** | Automated | Freshness checks against thuvienphapluat.vn |
### Key Laws Included
| Law | Coverage |
|-----|---------|
| Hiến pháp 2013 | Constitution |
| Bộ luật Hình sự 2015 (sửa đổi 2017) | Criminal Code |
| Bộ luật Dân sự 2015 | Civil Code |
| Luật An ninh mạng 2018 | Cybersecurity Law |
| Nghị định 13/2023/NĐ-CP | Personal Data Protection Decree |
| Luật Giao dịch điện tử 2023 | E-Transactions Law |
| Luật Doanh nghiệp 2020 | Enterprise Law |
| Luật Bảo vệ quyền lợi người tiêu dùng 2023 | Consumer Rights Law |
**Verified data only** -- every citation is validated against official sources (thuvienphapluat.vn). Zero LLM-generated content.
---
## See It In Action
### Why This Works
**Verbatim Source Text (No LLM Processing):**
- All statute text is ingested from thuvienphapluat.vn and luatvietnam.vn official sources
- Provisions are returned **unchanged** from SQLite FTS5 database rows
- Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations
**Smart Context Management:**
- Search returns ranked provisions with BM25 scoring (safe for context)
- Provision retrieval gives exact text by luật/nghị định identifier + điều/khoản
- Cross-references help navigate without loading everything at once
**Technical Architecture:**
```
thuvienphapluat.vn → Parse → SQLite → FTS5 snippet() → MCP response
↑ ↑
Provision parser Verbatim database query
```
### Traditional Research vs. This MCP
| Traditional Approach | This MCP Server |
|---------------------|-----------------|
| Search thuvienphapluat by tên văn bản | Search by plain Vietnamese: *"bảo vệ dữ liệu cá nhân"* |
| Navigate multi-điều statutes manually | Get the exact provision with context |
| Manual cross-referencing between luật and nghị định | `build_legal_stance` aggregates across sources |
| "Luật này còn hiệu lực không?" → manual check | `check_currency` tool → answer in seconds |
| No API, no integration | MCP protocol → AI-native |
**Traditional:** Search thuvienphapluat → Download PDF → Ctrl+F → Cross-reference with nghị định → Repeat
**This MCP:** *"Điều nào trong Nghị định 13/2023 quy định về đồng ý của chủ thể dữ liệu?"* → Done.
---
## Available Tools (13)
### Core Legal Research Tools (8)
| Tool | Description |
|------|-------------|
| `search_legislation` | FTS5 search on 3,226 provisions with BM25 ranking |
| `get_provision` | Retrieve specific provision by luật/nghị định identifier + điều/khoản |
| `validate_citation` | Validate citation against database (zero-hallucination check) |
| `build_legal_stance` | Aggregate citations from statutes and regulations |
| `format_citation` | Format citations per Vietnamese conventions (full/short/pinpoint) |
| `check_currency` | Check if statute is in force, amended, or repealed |
| `list_sources` | List all available statutes with metadata and data provenance |
| `about` | Server info, capabilities, dataset statistics, and coverage summary |
### International Law Alignment Tools (5)
| Tool | Description |
|------|-------------|
| `get_eu_basis` | Get international frameworks that a Vietnamese statute aligns with |
| `get_vietnamese_implementations` | Find Vietnamese laws aligning with international frameworks |
| `search_eu_implementations` | Search international documents with Vietnamese alignment counts |
| `get_provision_eu_basis` | Get international law references for a specific provision |
| `validate_eu_compliance` | Check alignment status of Vietnamese statutes against international standards |
---
## International & Comparative Law Alignment
Vietnam is not an EU member state, but Vietnamese law increasingly references and aligns with international frameworks, particularly in data protection, cybersecurity, and e-commerce.
### ASEAN Framework Alignment
Vietnam is a member of ASEAN and participates in regional legal harmonisation:
| ASEAN Framework | Vietnamese Alignment |
|----------------|---------------------|
| ASEAN Digital Masterplan 2025 | Luật An ninh mạng 2018, Nghị định 13/2023 |
| ASEAN Cross-Border Data Flows | Under development |
| ASEAN Framework on Personal Data Protection | Nghị định 13/2023 |
### WTO Commitments
| WTO Agreement | Vietnamese Implementation |
|--------------|--------------------------|
| TRIPS | Luật Sở hữu trí tuệ (amended 2022) |
| GATS (e-commerce) | Luật Giao dịch điện tử 2023 |
| TBT Agreement | Various technical standards legislation |
### Comparative EU Alignment
Vietnam has no EU adequacy decision. However, the international bridge tools allow you to explore comparative alignment:
- **Nghị định 13/2023** (Personal Data Protection) vs. GDPR -- similar consent, purpose limitation, and data subject rights principles, but with Vietnam-specific data localization requirements
- **Luật An ninh mạng 2018** vs. NIS2 -- overlapping cybersecurity incident reporting obligations with different scope and authority
- **Luật Giao dịch điện tử 2023** vs. eIDAS -- electronic signature and authentication frameworks with partial alignment
> **Note:** These tools identify comparative alignment, not legal equivalence. Vietnamese law operates under a civil law system with distinct legislative hierarchy (Luật > Nghị định > Thông tư > Quyết định).
---
## Data Sources & Freshness
All content is sourced from authoritative Vietnamese legal databases:
- **[thuvienphapluat.vn](https://thuvienphapluat.vn/)** -- Vietnam Legal Document Library
- **[luatvietnam.vn](https://luatvietnam.vn/)** -- Vietnam Law Database
### Data Provenance
| Field | Value |
|-------|-------|
| **Authority** | Văn phòng Chính phủ / Quốc hội |
| **Retrieval method** | HTML parse from thuvienphapluat.vn |
| **Language** | Vietnamese |
| **Coverage** | 93 core statutes (curated compliance-focused set) |
| **Last ingested** | 2026-02-25 |
### Automated Freshness Checks (Daily)
A [daily GitHub Actions workflow](.github/workflows/check-updates.yml) monitors all data sources:
| Source | Check | Method |
|--------|-------|--------|
| **Statute amendments** | Source date comparison | All 93 statutes checked |
| **New statutes** | thuvienphapluat.vn recent publications | Diffed against database |
---
## Security
This project uses multiple layers of automated security scanning:
| Scanner | What It Does | Schedule |
|---------|-------------|----------|
| **CodeQL** | Static analysis for security vulnerabilities | Weekly + PRs |
| **Semgrep** | SAST scanning (OWASP top 10, secrets, TypeScript) | Every push |
| **Gitleaks** | Secret detection across git history | Every push |
| **Trivy** | CVE scanning on filesystem and npm dependencies | Daily |
| **Socket.dev** | Supply chain attack detection | PRs |
| **Dependabot** | Automated dependency updates | Weekly |
See [SECURITY.md](SECURITY.md) for the full policy and vulnerability reporting.
---
## Important Disclaimers
### Legal Advice
> **THIS TOOL IS NOT LEGAL ADVICE**
>
> Statute text is sourced from thuvienphapluat.vn. However:
> - This is a **research tool**, not a substitute for professional legal counsel
> - **Coverage is limited** to 93 curated statutes -- not all Vietnamese legislation is included
> - **Court case coverage is not included** -- do not rely on this for case law research
> - **Verify critical citations** against primary sources for filings
> - **Ministerial guidance (Thông tư)** is only partially covered -- check relevant ministry websites for complete guidance
> - **Amendment tracking** -- Vietnamese law is frequently amended; always verify the current version
**Before using professionally, read:** [DISCLAIMER.md](DISCLAIMER.md) | [PRIVACY.md](PRIVACY.md)
### Client Confidentiality
Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment. See [PRIVACY.md](PRIVACY.md) for Liên đoàn Luật sư Việt Nam compliance guidance.
---
## Documentation
- **[International Alignment Guide](docs/INTERNATIONAL_ALIGNMENT.md)** -- ASEAN and comparative law documentation
- **[Security Policy](SECURITY.md)** -- Vulnerability reporting and scanning details
- **[Disclaimer](DISCLAIMER.md)** -- Legal disclaimers and professional use notices
- **[Privacy](PRIVACY.md)** -- Client confidentiality and data handling
---
## Development
### Setup
```bash
git clone https://github.com/Ansvar-Systems/vietnamese-law-mcp
cd vietnamese-law-mcp
npm install
npm run build
npm test
```
### Running Locally
```bash
npm run dev # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js # Test with MCP Inspector
```
### Data Management
```bash
npm run ingest # Ingest statutes from thuvienphapluat.vn
npm run build:db # Rebuild SQLite database
npm run drift:detect # Run drift detection
npm run check-updates # Check for amendments and new statutes
npm run census # Generate coverage census report
```
### Performance
- **Search Speed:** <100ms for most FTS5 queries
- **Database Size:** ~14 MB (efficient, portable)
- **Reliability:** 100% ingestion success rate
---
## Related Projects: Complete Compliance Suite
This server is part of **Ansvar's Compliance Suite** -- MCP servers that work together for end-to-end compliance coverage:
### [@ansvar/eu-regulations-mcp](https://github.com/Ansvar-Systems/EU_compliance_MCP)
**Query 49 EU regulations directly from Claude** -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. Full regulatory text with article-level search. `npx @ansvar/eu-regulations-mcp`
### @ansvar/vietnamese-law-mcp (This Project)
**Query 93 Vietnamese statutes directly from Claude** -- An ninh mạng, BLDS, BLHS, Giao dịch điện tử, and more. `npx @ansvar/vietnamese-law-mcp`
### [@ansvar/us-law-mcp](https://github.com/Ansvar-Systems/US-law-mcp)
**Query US federal compliance laws** -- HIPAA, CCPA, SOX, GLBA, FERPA, and more. `npx @ansvar/us-law-mcp`
### [@ansvar/security-controls-mcp](https://github.com/Ansvar-Systems/security-controls-mcp)
**Query 261 security frameworks** -- ISO 27001, NIST CSF, SOC 2, CIS Controls, SCF, and more. `npx @ansvar/security-controls-mcp`
**70+ national law MCPs** covering Austria, Belgium, Brazil, Canada, China, Denmark, France, Germany, Indonesia, Japan, South Korea, Malaysia, Netherlands, Norway, Philippines, Singapore, Sweden, Thailand, UK, and more.
---
## Contributing
Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
Priority areas:
- Statute coverage expansion (93 → 200+ statutes)
- Ministerial guidance (Thông tư) from key ministries (BCA, BTTTT, NHNN)
- Amendment tracking and version history
- Court decision coverage (Tòa án nhân dân tối cao)
---
## Roadmap
- [x] Core statute database with FTS5 search
- [x] Corpus ingestion (93 statutes, 3,226 provisions)
- [x] International law alignment tools
- [x] Vercel Streamable HTTP deployment
- [x] npm package publication
- [x] Daily freshness checks
- [ ] Statute coverage expansion (target: 200+ statutes)
- [ ] Ministerial guidance (Thông tư) coverage
- [ ] Court decision coverage (Tòa án nhân dân tối cao)
- [ ] Amendment tracking and version history
- [ ] English translations for key statutes
---
## Citation
If you use this MCP server in academic research:
```bibtex
@software{vietnamese_law_mcp_2026,
author = {Ansvar Systems AB},
title = {Vietnamese Law MCP Server: Production-Grade Legal Research Tool},
year = {2026},
url = {https://github.com/Ansvar-Systems/vietnamese-law-mcp},
note = {93 Vietnamese statutes with 3,226 provisions covering cybersecurity, data protection, and commercial law}
}
```
---
## License
Apache License 2.0. See [LICENSE](./LICENSE) for details.
### Data Licenses
- **Statutes & Legislation:** Văn phòng Chính phủ Việt Nam (public domain)
---
## About Ansvar Systems
We build AI-accelerated compliance and legal research tools for the global market. This MCP server helps organisations operating in Vietnam navigate the country's rapidly evolving digital and data protection legislation.
So we're open-sourcing it. Navigating 93 statutes across Luật, Nghị định, and Thông tư shouldn't require a law degree.
**[ansvar.eu](https://ansvar.eu)** -- Stockholm, Sweden
---
<p align="center">
<sub>Built with care in Stockholm, Sweden</sub>
</p>
