Ukrainian Law MCP Server

The Zakon.rada.gov.ua alternative for the AI age.

Query 8,165 Ukrainian statutes -- from the Закон про захист персональних даних and Кримінальний кодекс to Цивільний кодекс, Господарський кодекс, and more -- directly from Claude, Cursor, or any MCP-compatible client.

If you're building legal tech, compliance tools, or doing Ukrainian legal research, this is your verified reference database.

Built by Ansvar Systems -- Stockholm, Sweden

---

Why This Exists

Ukrainian legal research means navigating zakon.rada.gov.ua, the Верховна Рада's official database, across thousands of statutes with inconsistent numbering and frequent amendments. Whether you're:

• A lawyer validating citations in a brief or contract
• A compliance officer checking Ukrainian data protection or cybersecurity obligations
• A legal tech developer building tools on Ukrainian law
• A researcher tracking legislative changes during Ukraine's EU accession process

...you shouldn't need dozens of browser tabs and manual cross-referencing. Ask Claude. Get the exact provision. With context.

This MCP server makes Ukrainian 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://ukrainian-law-mcp.vercel.app/mcp

Client	How to Connect
Claude.ai	Settings > Connectors > Add Integration > paste URL
Claude Code	claude mcp add ukrainian-law --transport http https://ukrainian-law-mcp.vercel.app/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:

{
  "mcpServers": {
    "ukrainian-law": {
      "type": "url",
      "url": "https://ukrainian-law-mcp.vercel.app/mcp"
    }
  }
}

GitHub Copilot -- add to VS Code settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "ukrainian-law": {
      "type": "http",
      "url": "https://ukrainian-law-mcp.vercel.app/mcp"
    }
  }
}

Use Locally (npm)

npx @ansvar/ukrainian-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

{
  "mcpServers": {
    "ukrainian-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/ukrainian-law-mcp"]
    }
  }
}

Cursor / VS Code:

{
  "mcp.servers": {
    "ukrainian-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/ukrainian-law-mcp"]
    }
  }
}

---

Example Queries

Once connected, just ask naturally:

• "Пошук положень про 'захист персональних даних' в українському законодавстві"
• "Що говорить Кримінальний кодекс України про кіберзлочини?"
• "Знайди положення Цивільного кодексу про відшкодування збитків"
• "Які законодавчі акти регулюють електронну комерцію в Україні?"
• "Чи є Закон про захист персональних даних чинним?"
• "Search for provisions about data breach notification in Ukrainian law"
• "What EU directives does Ukraine's data protection law align with?"
• "Validate the citation 'Стаття 5 Закону про захист персональних даних'"

---

What's Included

Category	Count	Details
Statutes	8,165 statutes	Comprehensive Ukrainian legislation from zakon.rada.gov.ua
Provisions	50,710 sections	Full-text searchable with FTS5
Legal Definitions	0 (free tier)	Table reserved, extraction not enabled in current free build
Database Size	Optimized SQLite	Portable, pre-built
Daily Updates	Automated	Freshness checks against Верховна Рада

Verified data only -- every citation is validated against official sources (zakon.rada.gov.ua). Zero LLM-generated content.

---

See It In Action

Why This Works

Verbatim Source Text (No LLM Processing):

• All statute text is ingested from zakon.rada.gov.ua (Верховна Рада) 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 statute identifier + chapter/section
• Cross-references help navigate without loading everything at once

Technical Architecture:

zakon.rada.gov.ua API --> Parse --> SQLite --> FTS5 snippet() --> MCP response
                            ^                        ^
                     Provision parser         Verbatim database query

Traditional Research vs. This MCP

Traditional Approach	This MCP Server
Search zakon.rada.gov.ua by statute number	Search by plain Ukrainian: "персональні дані згода"
Navigate multi-chapter statutes manually	Get the exact provision with context
Manual cross-referencing between laws	build_legal_stance aggregates across sources
"Is this statute still in force?" -- check manually	check_currency tool -- answer in seconds
Find EU alignment -- dig through EUR-Lex	get_eu_basis -- linked EU directives instantly
Check multiple portals for amendments	Daily automated freshness checks
No API, no integration	MCP protocol -- AI-native

Traditional: Search zakon.rada.gov.ua --> Download PDF --> Ctrl+F --> Cross-reference with related statutes --> Check EUR-Lex for EU basis --> Repeat

This MCP: "Які вимоги щодо захисту персональних даних в Україні та як вони співвідносяться з GDPR?" -- Done.

---

Available Tools (13)

Core Legal Research Tools (8)

Tool	Description
search_legislation	FTS5 full-text search across 50,710 provisions with BM25 ranking. Supports Ukrainian and English queries
get_provision	Retrieve specific provision by statute identifier + chapter/section
check_currency	Check if a statute is in force, amended, or repealed
validate_citation	Validate citation against database -- zero-hallucination check
build_legal_stance	Aggregate citations from multiple statutes for a legal topic
format_citation	Format citations per Ukrainian conventions
list_sources	List all available statutes with metadata, coverage scope, and data provenance
about	Server info, capabilities, dataset statistics, and coverage summary

EU/International Law Integration Tools (5)

Tool	Description
get_eu_basis	Get EU directives/regulations that a Ukrainian statute aligns with
get_ukrainian_implementations	Find Ukrainian laws implementing or aligning with an EU act
search_eu_implementations	Search EU documents with Ukrainian alignment counts
get_provision_eu_basis	Get EU law references for a specific provision
validate_eu_compliance	Check alignment status of Ukrainian statutes against EU requirements

---

EU Law Integration

Ukraine is an EU accession candidate under the EU-Ukraine Association Agreement (in force since 2017). Ukraine is actively harmonising its legislation with EU law as part of the accession process.

Key alignment areas:

• Data protection: Закон про захист персональних даних aligns with GDPR principles; further reforms are underway as part of accession requirements
• Cybersecurity: Ukrainian cybersecurity legislation is being aligned with NIS2 and the EU Cybersecurity Act
• E-commerce and digital markets: Alignment with EU Digital Single Market legislation
• Competition law: Ongoing alignment with EU competition framework

The EU bridge tools allow you to explore these alignment relationships -- checking which Ukrainian provisions correspond to EU requirements, and vice versa.

Note: EU cross-references reflect alignment and approximation relationships under the Association Agreement, not full transposition. Ukraine adopts its own legislative approach, and the EU tools help identify where Ukrainian and EU law address similar domains. Full transposition obligations increase as accession negotiations progress.

---

Data Sources & Freshness

All content is sourced from authoritative Ukrainian legal databases:

• zakon.rada.gov.ua -- Верховна Рада (Verkhovna Rada) official legal database

Data Provenance

Field	Value
Authority	Верховна Рада України (Verkhovna Rada of Ukraine)
Retrieval method	Official API and structured data from zakon.rada.gov.ua
Languages	Ukrainian (primary)
License	Public domain (Ukrainian government official publications)
Coverage	8,165 statutes across all legislative domains

Automated Freshness Checks (Daily)

A daily GitHub Actions workflow monitors all data sources:

Source	Check	Method
Statute amendments	zakon.rada.gov.ua date comparison	All statutes checked
New statutes	Верховна Рада publications	Diffed against database
Repealed statutes	Status change detection	Flagged automatically

Verified data only -- every citation is validated against official sources. Zero LLM-generated content.

---

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
Docker Security	Container image scanning + SBOM generation	Daily
Socket.dev	Supply chain attack detection	PRs
OSSF Scorecard	OpenSSF best practices scoring	Weekly
Dependabot	Automated dependency updates	Weekly

See SECURITY.md for the full policy and vulnerability reporting.

---

Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE

Statute text is sourced from zakon.rada.gov.ua (Верховна Рада). However:

• This is a research tool, not a substitute for professional legal counsel
• Court case coverage is not included -- do not rely solely on this for case law research
• Verify critical citations against primary sources for court filings
• EU cross-references reflect alignment under the Association Agreement, not full transposition
• Ukrainian law is changing rapidly due to the ongoing EU accession process -- verify currency for any provision you rely on professionally

Before using professionally, read: DISCLAIMER.md | PRIVACY.md

Client Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment. See PRIVACY.md for guidance compliant with Національна асоціація адвокатів України (НААУ) professional responsibility rules.

---

Documentation

• EU Integration Guide -- Detailed EU cross-reference documentation
• EU Usage Examples -- Practical EU lookup examples
• Security Policy -- Vulnerability reporting and scanning details
• Disclaimer -- Legal disclaimers and professional use notices
• Privacy -- Client confidentiality and data handling

---

Development

Setup

git clone https://github.com/Ansvar-Systems/Ukrainian-law-mcp
cd Ukrainian-law-mcp
npm install
npm run build
npm test

Running Locally

npm run dev                                       # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector

Data Management

npm run ingest          # Ingest statutes from zakon.rada.gov.ua
npm run build:db        # Rebuild SQLite database
npm run drift:detect    # Run drift detection against known anchors
npm run check-updates   # Check for source updates

Performance

• Search Speed: <100ms for most FTS5 queries
• 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

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/ukrainian-law-mcp (This Project)

Query 8,165 Ukrainian statutes directly from Claude -- Закон про захист персональних даних, Кримінальний кодекс, Цивільний кодекс, and more. npx @ansvar/ukrainian-law-mcp

@ansvar/security-controls-mcp

Query 261 security frameworks -- ISO 27001, NIST CSF, SOC 2, CIS Controls, SCF, and more. npx @ansvar/security-controls-mcp

@ansvar/sanctions-mcp

Offline-capable sanctions screening -- OFAC, EU, UN sanctions lists. pip install ansvar-sanctions-mcp

100+ national law MCPs covering Australia, Belgium, Brazil, Canada, Denmark, Finland, France, Germany, Ireland, Italy, Netherlands, Norway, Poland, Sweden, Switzerland, UK, and more.

---

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

• Court case law expansion (Ukrainian courts)
• EU Regulations MCP integration (full EU law text)
• Historical statute versions and amendment tracking
• English translations for key statutes

---

Roadmap

• Core statute database with FTS5 search
• Full corpus ingestion (8,165 statutes, 50,710 provisions)
• EU/international law alignment tools
• Vercel Streamable HTTP deployment
• npm package publication
• Daily freshness checks
• Court case law expansion
• Historical statute versions (amendment tracking)
• English translations for key statutes
• EU accession progress tracking

---

Citation

If you use this MCP server in academic research:

@software{ukrainian_law_mcp_2026,
  author = {Ansvar Systems AB},
  title = {Ukrainian Law MCP Server: AI-Powered Legal Research Tool},
  year = {2026},
  url = {https://github.com/Ansvar-Systems/Ukrainian-law-mcp},
  note = {8,165 Ukrainian statutes with 50,710 provisions}
}

---

License

Apache License 2.0. See LICENSE for details.

Data Licenses

• Statutes & Legislation: Верховна Рада України (public domain, official government publications)
• EU Metadata: EUR-Lex (EU public domain)

---

About Ansvar Systems

We build AI-accelerated compliance and legal research tools for the global market. This MCP server started as our internal reference tool for Ukrainian law -- turns out everyone building compliance tools for businesses operating in Ukraine has the same research frustrations.

So we're open-sourcing it. Navigating 8,165 statutes shouldn't require 47 browser tabs.

ansvar.eu -- Stockholm, Sweden

---

_{Built with care in Stockholm, Sweden}