@ansvar/uae-law-mcp 1.1.2

package/fixtures/golden-tests.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "./golden-tests.schema.json",
+  "version": "1.0",
+  "mcp_name": "UAE Law MCP",
+  "description": "Golden contract tests for the UAE Law MCP covering federal data protection (PDPL), cybercrimes, electronic transactions, commercial companies, and DIFC/ADGM free zone data protection legislation",
+  "tests": [
+    {
+      "id": "ae-001",
+      "category": "article_retrieval",
+      "description": "Retrieve Article 2 of the Personal Data Protection Law (Federal Decree-Law No. 45/2021) — definitions including personal data, data controller, data processor",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 45/2021 on Personal Data Protection",
+        "article": "2"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "text_contains": ["personal data"],
+        "fields_present": ["text", "article_number"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "ae-002",
+      "category": "article_retrieval",
+      "description": "Retrieve Article 1 of the Cybercrimes Law (Federal Decree-Law No. 34/2021) — definitions and scope",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 34/2021 on Combatting Rumours and Cybercrimes",
+        "article": "1"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["cybercrime", "information system", "electronic"],
+        "fields_present": ["text", "article_number"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "ae-003",
+      "category": "article_retrieval",
+      "description": "Retrieve Article 1 of the DIFC Data Protection Law (Law No. 5/2020) — application and scope",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "DIFC Data Protection Law No. 5/2020",
+        "article": "1"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["personal data", "data protection", "DIFC"],
+        "fields_present": ["text"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "ae-004",
+      "category": "search",
+      "description": "Full-text search for 'personal data' returns PDPL and data protection provisions",
+      "tool": "search_legislation",
+      "input": {
+        "query": "personal data"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["Personal Data Protection", "personal data", "data controller"]
+      }
+    },
+    {
+      "id": "ae-005",
+      "category": "search",
+      "description": "Full-text search for 'cybercrime' returns Cybercrimes Law provisions",
+      "tool": "search_legislation",
+      "input": {
+        "query": "cybercrime"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["Combatting Rumours and Cybercrimes", "cybercrime", "information system"]
+      }
+    },
+    {
+      "id": "ae-006",
+      "category": "search",
+      "description": "Full-text search for 'electronic transaction' returns Electronic Transactions Law provisions",
+      "tool": "search_legislation",
+      "input": {
+        "query": "electronic transaction"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["Electronic Transactions", "electronic", "trust services"]
+      }
+    },
+    {
+      "id": "ae-007",
+      "category": "citation_roundtrip",
+      "description": "Citation for PDPL Article 3 includes moj.gov.ae or difclaws.com URL pattern",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 45/2021 on Personal Data Protection",
+        "article": "3"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "citation_url_pattern": "(moj\\.gov\\.ae|difclaws\\.com|adgm\\.com)",
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "ae-008",
+      "category": "citation_roundtrip",
+      "description": "Citation for Commercial Companies Law Article 1 includes official source reference",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Law No. 2/2015 on Commercial Companies",
+        "article": "1"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "fields_present": ["text"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "ae-009",
+      "category": "eu_cross_reference",
+      "description": "PDPL cross-reference to GDPR — the UAE PDPL was influenced by GDPR principles",
+      "tool": "get_provision_eu_basis",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 45/2021 on Personal Data Protection"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["GDPR", "General Data Protection Regulation", "2016/679", "data protection"]
+      }
+    },
+    {
+      "id": "ae-010",
+      "category": "eu_cross_reference",
+      "description": "DIFC Data Protection Law cross-reference to GDPR — DIFC DPL is closely modeled on GDPR",
+      "tool": "get_provision_eu_basis",
+      "input": {
+        "law_identifier": "DIFC Data Protection Law No. 5/2020"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["GDPR", "General Data Protection Regulation", "2016/679", "EU"]
+      }
+    },
+    {
+      "id": "ae-011",
+      "category": "negative_test",
+      "description": "Non-existent UAE law returns graceful error or empty result",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 9999/2099 on Fictional Matters",
+        "article": "1"
+      },
+      "assertions": {
+        "handles_gracefully": true
+      }
+    },
+    {
+      "id": "ae-012",
+      "category": "negative_test",
+      "description": "Malformed article number returns graceful error or empty result",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Federal Decree-Law No. 45/2021 on Personal Data Protection",
+        "article": "999ZZZ-INVALID"
+      },
+      "assertions": {
+        "handles_gracefully": true
+      }
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@ansvar/uae-law-mcp",
+  "version": "1.1.2",
+  "mcpName": "eu.ansvar/uae-law-mcp",
+  "description": "UAE law database covering federal data protection (PDPL), cybercrimes, electronic transactions, commercial companies, and DIFC/ADGM free zone data protection law with full-text search",
+  "author": "Ansvar Systems <hello@ansvar.eu>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ansvar-Systems/uae-law-mcp.git"
+  },
+  "homepage": "https://ansvar.eu",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "uae-law",
+    "pdpl",
+    "personal-data-protection",
+    "cybercrimes",
+    "electronic-transactions",
+    "commercial-companies",
+    "difc",
+    "adgm",
+    "legislation",
+    "legal",
+    "compliance",
+    "middle-east",
+    "ansvar"
+  ],
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "uae-law-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist/",
+    "data/database.db",
+    "sources.yml",
+    "fixtures/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:contract": "vitest run __tests__/contract/",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "start": "node dist/server.js",
+    "start:stdio": "node dist/server.js --stdio",
+    "health": "curl -s http://localhost:3000/health | jq .",
+    "build:db": "tsx scripts/build-db.ts",
+    "build:db:free": "tsx scripts/build-db-free.ts",
+    "ingest": "tsx scripts/ingest.ts",
+    "drift:detect": "tsx scripts/drift-detect.ts",
+    "check:freshness": "tsx scripts/check-freshness.ts",
+    "validate": "npm run lint && npm run test && npm run test:contract"
+  },
+  "dependencies": {
+    "@ansvar/mcp-sqlite": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.6.2",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "cheerio": "^1.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.4.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/sources.yml

@@ -0,0 +1,100 @@
+# sources.yml
+schema_version: "1.0"
+mcp_name: "UAE Law MCP"
+jurisdiction: "AE"
+
+sources:
+  - name: "UAE Ministry of Justice (Official Legislation Portal)"
+    authority: "Ministry of Justice, United Arab Emirates"
+    official_portal: "https://moj.gov.ae"
+    canonical_identifier: "N/A (UAE legislation identified by Federal Decree-Law/Law number and year; no standardized URI scheme)"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "monthly"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Government Open Data"
+      url: "https://moj.gov.ae"
+      summary: "UAE federal legislation is publicly available through the Ministry of Justice portal; government publications are accessible for informational purposes"
+    coverage:
+      scope: "Federal Decree-Laws, Federal Laws, Cabinet Decisions, and ministerial resolutions including PDPL (45/2021), Cybercrimes Law (34/2021), Electronic Transactions Law (46/2021), Commercial Companies Law (2/2015), and related implementing regulations"
+      limitations: "Emirate-level legislation not comprehensively covered; historical laws prior to digitization may be incomplete; implementing regulations may lag behind primary legislation; Arabic is the authoritative language — English translations are unofficial unless from DIFC/ADGM"
+    languages:
+      - "ar"
+      - "en"
+
+  - name: "DIFC Laws and Regulations"
+    authority: "Dubai International Financial Centre (DIFC)"
+    official_portal: "https://difclaws.com"
+    canonical_identifier: "DIFC Law No. [number]/[year]"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "on_change"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Government Open Data"
+      url: "https://difclaws.com/terms"
+      summary: "DIFC laws and regulations are published in English and freely accessible; DIFC is a common-law jurisdiction within Dubai with its own courts and regulatory framework"
+    coverage:
+      scope: "DIFC Data Protection Law (Law No. 5/2020), DIFC Operating Law, DIFC Companies Law, DIFC Employment Law, DIFC Insolvency Law, DIFC Arbitration Law, and all DIFC regulations and rules of court"
+      limitations: "Only covers DIFC free zone laws; does not include Dubai or UAE federal legislation; DIFC court decisions not fully indexed"
+    languages:
+      - "en"
+
+  - name: "ADGM Legal Framework"
+    authority: "Abu Dhabi Global Market (ADGM)"
+    official_portal: "https://adgm.com/legal-framework"
+    canonical_identifier: "ADGM Regulations [year]"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "on_change"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Government Open Data"
+      url: "https://adgm.com/legal-framework"
+      summary: "ADGM laws and regulations are published in English and freely accessible; ADGM is a common-law jurisdiction within Abu Dhabi with its own courts and regulatory framework"
+    coverage:
+      scope: "ADGM Data Protection Regulations 2021, ADGM Companies Regulations, ADGM Financial Services regulations, ADGM Employment Regulations, and all ADGM guidance and rules"
+      limitations: "Only covers ADGM free zone laws; does not include Abu Dhabi emirate or UAE federal legislation; ADGM court decisions not fully indexed"
+    languages:
+      - "en"
+
+  - name: "WAM (Emirates News Agency) — Official Gazette"
+    authority: "Emirates News Agency (WAM)"
+    official_portal: "https://www.wam.ae"
+    canonical_identifier: "N/A (gazette notices by date and number)"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "weekly"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Government Publication"
+      url: "https://www.wam.ae"
+      summary: "Official UAE government news and gazette publications; WAM is the official state news agency and publishes legislative announcements"
+    coverage:
+      scope: "Official government gazette notices, promulgation announcements for new Federal Decree-Laws, and regulatory updates"
+      limitations: "Not a structured legal database; primarily news announcements; full legal texts must be obtained from MOJ or official gazette"
+    languages:
+      - "ar"
+      - "en"
+
+data_freshness:
+  automated_checks: true
+  check_frequency: "weekly"
+  last_verified: "PENDING_FIRST_INGEST"
+
+# Notes:
+# - UAE has a complex multi-layered legal system: Federal law applies across all
+#   emirates, but free zones (DIFC in Dubai, ADGM in Abu Dhabi) have their own
+#   independent legal systems based on common law (English language)
+# - The federal Personal Data Protection Law (PDPL, Federal Decree-Law No. 45/2021)
+#   is the overarching data protection framework, effective January 2, 2022
+# - DIFC Data Protection Law (Law No. 5/2020) and ADGM Data Protection Regulations 2021
+#   are separate regimes that apply within their respective free zones
+# - The UAE Data Office (established 2022) oversees implementation of the federal PDPL
+# - Arabic is the official legal language for federal legislation; DIFC and ADGM laws
+#   are natively drafted in English
+# - The Cybercrimes Law (Federal Decree-Law No. 34/2021) replaced the older
+#   Federal Decree-Law No. 5/2012 on Combating Cybercrimes
+# - Telecommunications Regulatory Authority (TRA, now TDRA) regulates ICT sector
+# - Critical for Ansvar's Middle East market expansion