io.github.overtimepog/CloakMCP

Launch a stealth CloakBrowser instance. All anti-detection is ON by default. CloakBrowser is a source-patched Chromium passing Cloudflare Turnstile, reCAPTCHA v3 (0.9 score), FingerprintJS, BrowserScan, and 30+ detectors. Args: headless: Run headless. Some aggressive sites need headed mode (False). proxy: Proxy URL (e.g. 'http://user:pass@proxy:8080'). Residential recommended. humanize: Human-like mouse/keyboard/scroll (default: True). human_preset: 'default' or 'careful' (slower, more deliberate). stealth_args: Apply stealth fingerprint args (default: True). timezone: IANA timezone (e.g. 'America/New_York'). locale: BCP 47 locale (e.g. 'en-US'). geoip: Auto-detect timezone/locale from proxy IP. fingerprint_seed: Fixed seed for consistent identity across sessions. user_data_dir: Persistent profile path (cookies/localStorage survive restarts). viewport_width: Viewport width in pixels (default: 1920 headless; 1280 headed fallback, or auto-detected). viewport_height: Viewport height in pixels (default: 947 headless; 800 headed fallback, or auto-detected). color_scheme: 'light', 'dark', or 'no-preference'. user_agent: Custom user agent override. extra_args: Additional Chromium CLI flags.

Close the stealth browser and release all resources. Always call when done.

Open a new browser page/tab. Optionally navigate to a URL. Args: url: URL to navigate to after creating the page.

List all open pages with their IDs and URLs.

Capture the page's accessibility tree — the PRIMARY way to understand pages. Returns interactive elements with [@eN] ref IDs for use with cloak_click, cloak_type, cloak_select, etc. Call this BEFORE interacting with a page. full=False (default): interactive elements only — compact and fast. full=True: includes surrounding text content for reading context. This is FASTER, CHEAPER, and MORE RELIABLE than screenshots. Always prefer this over cloak_screenshot for deciding what to click. Args: page_id: Target page ID from cloak_launch or cloak_new_page. full: Include text content alongside interactive elements. max_length: Max characters to return (default: 12000).

Click an element by its [@eN] ref ID from cloak_snapshot. Auto-retries once if the element moved. Returns an updated snapshot. Args: page_id: Target page ID. ref: Ref ID from snapshot (e.g. '@e5' or 'e5').

Type text into an input by its [@eN] ref ID from cloak_snapshot. Clears the field first by default. Set submit=True to press Enter after. Returns an updated snapshot. Args: page_id: Target page ID. ref: Ref ID from snapshot (e.g. '@e3' or 'e3'). text: Text to type. clear: Clear field before typing (default: True). submit: Press Enter after typing (default: False).

Select a dropdown option by ref ID. Provide one of: value, label, or index. Returns an updated snapshot. Args: page_id: Target page ID. ref: Ref ID of the <select> element. value: Option value attribute to select. label: Option visible text to select. index: Option index (0-based) to select.

Hover over an element by ref ID. Returns an updated snapshot. Args: page_id: Target page ID. ref: Ref ID from snapshot.

Check or uncheck a checkbox/radio by ref ID. Returns an updated snapshot. Args: page_id: Target page ID. ref: Ref ID from snapshot. checked: True to check, False to uncheck.

Get the page content as clean, readable markdown. Best for reading articles, docs, search results, or any content-heavy page. Strips navigation, ads, footers — returns just the main content. Much more token-efficient than raw HTML (60-80% savings). Args: page_id: Target page ID. max_length: Max characters to return (default: 50000).

Take an annotated screenshot with element indices overlaid. Each numbered element maps to [@eN] refs from cloak_snapshot. Use when you need VISUAL context — images, charts, CAPTCHAs, or layout. For most interactions, prefer cloak_snapshot() instead. Returns: file path to saved PNG, element count. Args: page_id: Target page ID. full_page: Capture entire scrollable page (default: viewport only).

Navigate to a URL. Auto-waits for the page to settle (network idle + DOM stable). Handles Cloudflare challenge pages with extra wait time. Returns an updated snapshot of the loaded page. Args: page_id: Target page ID. url: URL to navigate to. timeout: Navigation timeout in milliseconds.

Navigate back in browser history. Returns an updated snapshot. Args: page_id: Target page ID.

Navigate forward in browser history. Returns an updated snapshot. Args: page_id: Target page ID.

Press a keyboard key (Enter, Tab, Escape, ArrowDown, etc.). Returns an updated snapshot. Args: page_id: Target page ID. key: Key name (DOM KeyboardEvent key).

Scroll the page. Returns an updated snapshot. Args: page_id: Target page ID. direction: 'up' or 'down'. amount: Pixels to scroll.

Wait for the page to settle (no DOM mutations + network idle). Use after actions that trigger dynamic content loading. Returns whether the page settled and how many DOM mutations occurred. Args: page_id: Target page ID. timeout_ms: Max wait time in milliseconds (default: 5000).

Execute JavaScript in the page context and return the result. Args: page_id: Target page ID. expression: JavaScript expression to evaluate.

Close a specific page by ID. Args: page_id: Page ID to close.

Intercept network requests — block, mock, or passthrough. Args: page_id: Target page ID. url_pattern: Glob pattern (e.g. '**/api/**', '**/*.png'). action: 'block', 'mock', or 'continue'. mock_body: Response body for 'mock' action. mock_status: HTTP status for 'mock' action. mock_content_type: Content-Type for 'mock' action.

Remove a network interception rule. Args: page_id: Target page ID. url_pattern: Same pattern used in cloak_network_intercept.

Get all cookies from the page's browser context. Args: page_id: Target page ID.

Set cookies in the page's browser context. Args: page_id: Target page ID. cookies: List of cookie dicts with name, value, domain, path.

Save the current page as a PDF file. Args: page_id: Target page ID. format: Page format — 'A4', 'Letter', 'Legal'. print_background: Include background graphics.

Get browser console output (log/warn/error/info) and JS errors. Args: page_id: Target page ID. clear: Clear the message buffer after reading.

Get list of files downloaded by the browser on a page. Returns downloaded file info including suggested filenames and local paths. After clicking a download link, call this to retrieve the downloaded file path. Args: page_id: Target page ID.