@ansvar/turkish-law-mcp

Turkish Law MCP Server

The mevzuat.gov.tr alternative for the AI age.

Query 994 Turkish laws -- from KVKK and Anayasa to Siber Guvenlik Kanunu, Turk Ticaret Kanunu, and more -- directly from Claude, Cursor, or any MCP-compatible client.

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

Built by Ansvar Systems -- Stockholm, Sweden

Why This Exists

Turkish legal research requires navigating mevzuat.gov.tr, Resmi Gazete archives, and scattered regulatory databases. Whether you're:

• A lawyer validating citations in a contract or filing
• A compliance officer checking KVKK data protection requirements
• A legal tech developer building tools on Turkish law
• A researcher analyzing Turkish legislative structure

...you shouldn't need to navigate a government portal with iframe-embedded Word documents. Ask Claude. Get the exact provision. With context.

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

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

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

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

Use Locally (npm)

npx @ansvar/turkish-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": {
    "turkish-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/turkish-law-mcp"]
    }
  }
}

Cursor / VS Code:

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

Example Queries

Once connected, just ask naturally:

• "KVKK Madde 5 ne diyor? Kisisel verilerin islenmesi sartlari nedir?"
• "What does Article 20 of the Turkish Constitution say about privacy?"
• "Siber Guvenlik Kanunu'nun amaci nedir?"
• "Elektronik ticaret ile ilgili Turk mevzuatini bul"
• "KVKK'da veri sorumlusunun yukumlulukleri nelerdir?"
• "Find provisions about bilisim suclari in Turkish criminal law"
• "What are the penalties under Law 5651 for internet regulation violations?"
• "Turk Ticaret Kanunu'nda elektronik ticaret hukumleri neler?"

What's Included

Category	Count	Details
Laws (Kanunlar)	898 laws	All in-force Turkish laws from mevzuat.gov.tr
Decree Laws (KHK)	63	Kanun Hukmunde Kararnameler
Presidential Decrees	33	Cumhurbaskanligi Kararnameleri
Provisions	21,732 articles	Full-text searchable with FTS5
Legal Definitions	3,819 terms	Extracted from Tanimlar articles
Database Size	~49 MB	Optimized SQLite, portable
Daily Updates	Automated	Freshness checks against mevzuat.gov.tr

Verified data only -- every provision is ingested from the official Cumhurbaskanligi Mevzuat Bilgi Sistemi (mevzuat.gov.tr). Zero LLM-generated content.

Key Laws Included

Law	Number	Description
KVKK	6698	Personal Data Protection Law
Anayasa	2709	Constitution of the Republic of Turkey
Siber Guvenlik Kanunu	7545	Cybersecurity Law
Iklim Kanunu	7552	Climate Law
Law 5651	5651	Internet Regulation Law
TCK	5237	Turkish Criminal Code (including cybercrime arts. 243-246)
TTK	6102	Turkish Commercial Code
E-Commerce Law	6563	Electronic Commerce Regulation
EHK	5809	Electronic Communications Law
E-Signature Law	5070	Electronic Signature Law
Payment Services	6493	Payment Services and Electronic Money Law

See It In Action

Why This Works

Verbatim Source Text (No LLM Processing):

• All statute text is ingested from mevzuat.gov.tr official HTML pages
• 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 law number + article number
• Cross-references help navigate without loading everything at once

Technical Architecture:

mevzuat.gov.tr API -> Census -> Ingest -> Parse -> SQLite -> FTS5 snippet() -> MCP response
                        |                   |
                  994 laws enumerated   Article parser (Madde/Gecici Madde/Ek Madde)

Available Tools (8)

Core Legal Research Tools (8)

Tool	Description
search_legislation	FTS5 search on 21,732 provisions with BM25 ranking
get_provision	Retrieve specific provision by law name + article number
validate_citation	Validate citation against database (zero-hallucination check)
build_legal_stance	Aggregate citations from multiple statutes
format_citation	Format citations per Turkish legal conventions
check_currency	Check if statute is in force, amended, or repealed
get_eu_basis	Get EU directives/regulations referenced in Turkish statute
get_provision_eu_basis	Get EU law references for specific provision

Data Sources & Freshness

All content is sourced from the authoritative Turkish government legislation portal:

• mevzuat.gov.tr -- Cumhurbaskanligi Mevzuat Bilgi Sistemi (Presidency Legislation Information System)
• Resmi Gazete -- Official Gazette of Turkey (for publication dates)

Census-Driven Ingestion

The ingestion pipeline follows a census-first approach:

• Census (scripts/census.ts): Calls the MevzuatDatatable API to enumerate all laws
• Ingest (scripts/ingest.ts): Fetches each law's full text via the iframe content endpoint
• Parse (scripts/lib/parser.ts): Extracts articles (Madde), transitional articles (Gecici Madde), additional articles (Ek Madde), and definitions
• Build (scripts/build-db.ts): Compiles all seed files into the SQLite database with FTS5

Automated Freshness Checks (Daily)

A daily GitHub Actions workflow monitors mevzuat.gov.tr for:

Check	Method
New laws	MevzuatDatatable API pagination
Amendments	Content hash comparison
Repealed laws	Status field monitoring

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

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 official mevzuat.gov.tr publications. However:

• This is a research tool, not a substitute for professional legal counsel
• Verify critical citations against primary sources for court filings
• Amendment tracking may have delays -- always check mevzuat.gov.tr for the latest version
• Some laws (especially amendment laws) may have 0 parsed provisions if they only modify other statutes

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.

Development

Setup

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

Data Management

npm run census                          # Enumerate all laws from mevzuat.gov.tr
npm run ingest                          # Full ingestion (census-driven)
npm run ingest -- --limit 10            # Test with 10 laws
npm run ingest -- --resume              # Resume from where you left off
npm run ingest -- --skip-fetch          # Reuse cached HTML
npm run build:db                        # Rebuild SQLite database
npm run check-updates                   # Check for amendments
npm run drift:detect                    # Detect data drift

Running Locally

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

Performance

• Search Speed: <100ms for most FTS5 queries
• Database Size: ~49 MB (efficient, portable)
• Ingestion Time: ~9 minutes for full corpus (994 laws)
• Zero failures: 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. npx @ansvar/eu-regulations-mcp

@ansvar/swedish-law-mcp

Query 2,415 Swedish statutes directly from Claude -- DSL, BrB, ABL, MB, and more. npx @ansvar/swedish-law-mcp

@ansvar/us-regulations-mcp

Query US federal and state compliance laws -- HIPAA, CCPA, SOX, GLBA, FERPA, and more. npx @ansvar/us-regulations-mcp

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

• EU cross-reference extraction (Turkey is an EU candidate country)
• English translations for key statutes
• Amendment history tracking
• Secondary legislation (Yonetmelikler, Tebligler)

Roadmap

• Full corpus census -- 994 laws enumerated from MevzuatDatatable API
• Census-driven ingestion -- 21,732 provisions from 994 laws
• Definition extraction -- 3,819 legal definitions
• FTS5 full-text search -- unicode61 tokenizer for Turkish text
• EU cross-reference extraction (KVKK -> GDPR, etc.)
• Secondary legislation (Yonetmelikler, Tuzukler)
• English translations for key statutes
• Historical statute versions (amendment tracking)

Citation

If you use this MCP server in academic research:

@software{turkish_law_mcp_2026,
  author = {Ansvar Systems AB},
  title = {Turkish Law MCP Server: Production-Grade Legal Research Tool},
  year = {2026},
  url = {https://github.com/Ansvar-Systems/turkish-law-mcp},
  note = {Comprehensive Turkish legal database with 994 laws and 21,732 provisions}
}

License

Apache License 2.0. See LICENSE for details.

Data Licenses

• Statutes & Legislation: Cumhurbaskanligi Mevzuat Bilgi Sistemi (Government Public Data)
• Official Gazette Metadata: Resmi Gazete (public domain)

About Ansvar Systems

We build AI-accelerated compliance and legal research tools for the European market. This MCP server makes Turkish law searchable, cross-referenceable, and AI-readable -- so you can focus on analysis, not navigation.

ansvar.eu -- Stockholm, Sweden

_{Built with care in Stockholm, Sweden}