DarkLens MCP Server 🤖🔍

Real-time deceptive design and dark pattern compliance auditor for AI coding agents.

DarkLens MCP connects Cursor, Windsurf, Claude Desktop, Antigravity, Lovable, v0, and Cline directly to the DarkLens compliance auditing engine. Your AI coding agent can automatically audit staging URLs, check newly generated JSX/HTML components for deceptive patterns (GDPR, FTC Act Sec. 5, CCPA, EU DSA), and fix non-compliant UI before code is committed.

⚡ Quickstart Configuration by Coding Agent

1. 🖱️ Cursor

1. Go to Cursor Settings (Ctrl + , or Cmd + ,) → Features → MCP.

2. Click + Add New MCP Server.

3. Fill in:

   • Name: darklens

   • Type: command

   • Command: npx -y darklens-mcp

   • Environment Variables: DARKLENS_API_KEY=dl_live_YOUR_KEY

4. In Cursor Chat or Composer, prompt:

   "@darklens audit my checkout page and fix any illegal dark patterns."

2. 🌊 Windsurf (Codeium)

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "darklens": {
      "command": "npx",
      "args": ["-y", "darklens-mcp"],
      "env": {
        "DARKLENS_API_KEY": "dl_live_YOUR_KEY"
      }
    }
  }
}

3. 🧠 Claude Desktop / Claude Code (Anthropic)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "darklens": {
      "command": "npx",
      "args": ["-y", "darklens-mcp"],
      "env": {
        "DARKLENS_API_KEY": "dl_live_YOUR_KEY"
      }
    }
  }
}

4. 🚀 Antigravity (Google / DeepMind)

Add to your Antigravity MCP settings or call via native MCP config:

{
  "mcpServers": {
    "darklens": {
      "command": "npx",
      "args": ["-y", "darklens-mcp"],
      "env": {
        "DARKLENS_API_KEY": "dl_live_YOUR_KEY"
      }
    }
  }
}

5. ❤️ Lovable & v0 / Bolt.new

In Lovable, Bolt.new, or v0 terminal or agent custom tool integrations, execute:

npx -y darklens-mcp --key dl_live_YOUR_KEY

Or instruct the agent to run DarkLens CLI on preview URLs:

npx darklens <your-preview-url> --key $DARKLENS_API_KEY

6. 💻 VS Code (Cline / Roo Code)

1. Open the Cline / Roo Code sidebar tab.

2. Click the MCP icon → Configure MCP Servers.

3. Add:

{
  "mcpServers": {
    "darklens": {
      "command": "npx",
      "args": ["-y", "darklens-mcp"],
      "env": {
        "DARKLENS_API_KEY": "dl_live_YOUR_KEY"
      }
    }
  }
}

Related MCP server: pageguard-mcp

🛠️ Exposed MCP Tools

🔑 Authentication

Every request requires a DarkLens API key (dl_live_...). Get your key at darklens.dev/dashboard.

📄 License

MIT © DarkLens