Skip to main content
Glama

Autoconsent MCP

A Model Context Protocol server that provides browser automation capabilities specifically designed for creating and testing Autoconsent rules. This server enables LLMs to interact with web pages, inspect consent management platforms (CMPs), and test Autoconsent rules in a real browser environment.

CAUTION

This server can access local files and local/internal IP addresses since it runs a browser on your machine. Exercise caution when using this MCP server to ensure this does not expose any sensitive data.

Components

Tools

  • navigate

    • Navigate to any URL in the browser

    • Inputs:

      • url (string, required): URL to navigate to

  • screenshot

    • Capture screenshots of the entire page or specific elements

    • Inputs:

      • name (string, required): Name for the screenshot

      • width (number, optional, default: 1280): Screenshot width

      • height (number, optional, default: 720): Screenshot height

      • encoded (boolean, optional): If true, capture the screenshot as a base64-encoded data URI (as text) instead of binary image content. Default false.

  • click

    • Click elements on the page

    • Input: selector (string): CSS selector for element to click

  • select

    • Select an element with SELECT tag

    • Inputs:

      • selector (string): CSS selector for element to select

      • value (string): Value to select

  • evaluate

    • Execute JavaScript in the browser console

    • Input: script (string): JavaScript code to execute

  • search_html

    • Outputs the HTML of elements that deeply contain the given search query. Elements that don't contain the given query are omitted using a [...] placeholder.

    • Input: query (string): Search query

  • print_element

    • Outputs the full HTML of the given element

    • Input: selector (string): CSS selector

  • test_rule

    • Tests the given Autoconsent rule on the given URL

    • Inputs:

      • url (string, required): URL to navigate to

      • rule (object, required): Autoconsent rule (AutoConsentCMPRule)

Resources

The server provides access to two types of resources:

  1. Console Logs (console://logs)

    • Browser console output in text format

    • Includes all console messages from the browser

  2. Screenshots (screenshot://)

    • PNG images of captured screenshots

    • Accessible via the screenshot name specified during capture

Related MCP server: Puppeteer MCP Server

Installation and Setup

Prerequisites

  • Node.js (version 18 or higher)

  • npm

Setup

npm install
npm run build

Running the Server

For development:

npm run dev

For production:

npm start

Test Site

npm run serve-test-site

This starts a local HTTP server on port 8080 serving the test-site directory.

Testing

npm run test:unit
npm run test:integration

Note that the integration tests require the test site to be running (see above).

Configuration for Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "autoconsent-mcp": {
      "command": "node",
      "args": ["path/to/autoconsent-mcp/dist/index.js"]
    }
  }
}

Attribution and license

This project is based on the Puppeteer MCP server from https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer.

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.

Available Tools

10 tools
clickC

Click elements on the page

Inputs: selector (required).

evaluateC

Execute JavaScript in the browser console

Inputs: script (required).

reloadB

Reload the current page

Inputs: no named parameters.

reset_browser_dataC

Reset browser data including cookies, cache, localStorage, and sessionStorage

Inputs: clearCookies, clearCache, clearLocalStorage, clearSessionStorage.

screenshotC

Capture screenshots of the entire page or specific elements

Inputs: name (required), width, height, encoded.

search_htmlA

Outputs the HTML of elements that deeply contain the given search query. Elements that don't contain the given query are omitted using a [...] placeholder.

Inputs: query (required).

selectC

Select an element with SELECT tag

Inputs: selector (required), value (required).

test_ruleC

Tests the given Autoconsent rule on the given URL

Inputs: url (required), rule (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes, but 'evaluate' and 'test_rule' could be confused as both involve executing code or rules in the browser context. The other tools like 'click', 'navigate', and 'screenshot' are clearly differentiated by their specific actions on web pages.

    Naming Consistency3/5

    The naming is mixed with some tools using verb_noun patterns like 'print_element' and 'search_html', while others are single verbs like 'click' and 'reload'. There is no consistent convention across all tools, but the names are generally readable and descriptive of their functions.

    Tool Count5/5

    With 10 tools, the count is well-scoped for a browser automation and testing server. Each tool appears to serve a specific purpose in interacting with web pages, such as navigation, element manipulation, and data resetting, making the set comprehensive without being overwhelming.

    Completeness4/5

    The toolset covers core browser automation tasks like navigation, interaction, and inspection, with notable tools for Autoconsent-specific testing. A minor gap is the lack of tools for handling pop-ups or alerts, which are common in consent management scenarios, but agents can work around this using existing tools like 'click' or 'evaluate'.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
      19
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
      7
      1
      MIT