Skip to main content
Glama
@b2apps/gdpr-ropa-audit-mcp

@b2apps/gdpr-ropa-audit-mcp

README.md
# `@b2apps/gdpr-ropa-audit-mcp` — GDPR Art. 30 RoPA, ePrivacy Cookie Classifier & DPA/SCC Auditor MCP Server

Deterministic **Model Context Protocol (MCP)** server (`JSON-RPC 2.0` over `stdio` + Cloudflare Worker remote metered gateway in `src/worker.mjs`) for EU/UK privacy engineering, GDPR Article 30 Record of Processing Activities (RoPA) validation, ePrivacy Directive cookie/tracker classification, and Article 28 Data Processing Agreement (DPA) + Cross-Border Transfer (EU-US DPF & 2021 SCC Module 1–4) auditing.

> **Disclaimer:** *Educational & privacy-engineering planning tool only; not legal, regulatory, financial, or tax advice. Consult qualified data protection counsel or your Data Protection Officer (DPO) for formal GDPR and ePrivacy compliance sign-off.*

---

## Included MCP Tools

1. **`audit_gdpr_ropa_record`**
   - Validates a Record of Processing Activities (`GDPR Art. 30`) JSON string or object across all 9 mandatory regulatory dimensions:
     - Controller contact details (`Art. 30(1)(a)`)
     - Data Protection Officer (`DPO`) contact or documented `Art. 37` exemption (`Art. 30(1)(a)`)
     - Specific purposes of processing (`Art. 30(1)(b)`)
     - Lawful basis under `Art. 6(1)` (plus LIA check when relying on `Art. 6(1)(f)` Legitimate Interests)
     - Special categories of personal data (`Art. 9`) and data subject/category inventory (`Art. 30(1)(c)`)
     - Categories of recipients (`Art. 30(1)(d)`)
     - Third-country transfers & `Chapter V` safeguards (`2021 SCCs`, `EU-US DPF`, `Art. 45 Adequacy`) (`Art. 30(1)(e)`)
     - Defined retention schedule / storage limitation (`Art. 30(1)(f)` & `Art. 5(1)(e)`)
     - Technical and Organisational Measures (`TOMs` under `Art. 32` & `Art. 30(1)(g)`)
   - Returns a deterministic `0–100` compliance score, letter grade (`A–F`), and actionable missing-field remediation list.

2. **`classify_cookies_and_trackers`**
   - Classifies cookie and script identifiers (`_ga`, `_gid`, `_fbp`, `cf_clearance`, `__stripe_mid`, `stripe_mid`, `ph_*`, `intercom-id-*`, `OptanonConsent`, etc.) into:
     - **Strictly Necessary** (Exempt from prior opt-in under `ePrivacy Directive Art. 5(3)`)
     - **Analytics** (Prior opt-in consent required under `ePrivacy Art. 5(3)` & `GDPR Art. 6(1)(a)`)
     - **Marketing** (Prior explicit opt-in consent required)
     - **Functional** (Consent required unless strictly necessary for a user-requested UI preference)
   - Outputs per-cookie vendor, purpose, typical duration, CMP bucket, and banner implementation guidance.

3. **`generate_dpa_scc_checklist`**
   - Generates a deterministic **GDPR Art. 28 Data Processing Agreement (DPA)** checklist (`Art. 28(3)(a)–(h)`) and **Chapter V Cross-Border Transfer** checklist tailored to exporter/importer roles (`Controller` / `Processor`), destination country (`US`, `GB`, `IN`, `DE`, etc.), `EU-U.S. Data Privacy Framework (DPF)` status, and automatic selection of **2021 EU Standard Contractual Clauses (Decision (EU) 2021/914) Module 1, 2, 3, or 4** + Transfer Impact Assessment (`TIA`) requirements.

---

## Client Configuration (`mcpServers`)

Add to your `claude_desktop_config.json`, Cursor `.cursor/mcp.json`, or Windsurf MCP settings:

```json
{
  "mcpServers": {
    "gdpr-ropa-audit": {
      "command": "npx",
      "args": ["-y", "@b2apps/gdpr-ropa-audit-mcp"],
      "env": {
        "MCP_PRO_LICENSE_KEY": "OPTIONAL_PRO_KEY"
      }
    }
  }
}
```

---

## Network, Telemetry & Privacy Disclosure

- **Offline Local `stdio` Execution:** All 3 tools in `src/index.mjs` run **100% locally and offline** on your machine with **zero external network calls, zero telemetry, and zero logging** of your RoPA records, cookie inventories, or vendor checklists.
- **Optional Remote Metered Cloudflare Worker (`src/worker.mjs`):** Teams deploying or connecting to the hosted Streamable HTTP endpoint (`/mcp`) transmit JSON-RPC payloads over TLS 1.3 and can pass `X-MCP-Pro-Key` or `Authorization: Bearer <MCP_PRO_LICENSE_KEY>` for remote metered Pro access.

## Pricing, Licensing & Billing Tiers

- **Free Tier (MIT Open-Source):** Unlimited local `stdio` usage of `audit_gdpr_ropa_record`, `classify_cookies_and_trackers`, and `generate_dpa_scc_checklist`.
- **Pro Tier ($19/month Metered Gateway & Enterprise CI):** Hosted Cloudflare Worker remote MCP endpoint (`src/worker.mjs`), multi-record batch CI/CD RoPA validation, and priority regulatory rule updates via LemonSqueezy: [https://b2apps.lemonsqueezy.com/buy/gdpr-ropa-audit-mcp-pro](https://b2apps.lemonsqueezy.com/buy/gdpr-ropa-audit-mcp-pro).