# unblink [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/ChristopherDavenport/unblink  
**GitHub Stars:** 8  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/unblink

## Description
Pure-Go browser for AI: fetch pages, render JS without Chromium, return clean Markdown over MCP.

## Tools
Capabilities this server exposes over MCP:

- **read** — Main content (`mode=article`, default) or whole page (`full`) as Markdown, paginated via cursor. `format=raw_html` returns the unreduced source (optionally scoped by a CSS `selector`) — the escape hatch for scripts/forms/SSR-embedded JSON that reduction strips; `format=text` returns visible plain t…
- **browse** — Cheap orientation: title, description, lang, heading outline, link/form/image counts, excerpt, semantic region map, plus `llms_txt`/`robots` presence hints. Also returns a `collections` inventory — auto-detected repeating record-sets (product lists, search results, table-like rows), each with a rea…
- **links** — The page's links (text + absolute href), optionally filtered. `limit` defaults to 200 (cap 1000); `total`/`truncated` report the rest.
- **forms** — The page's forms and their fields (name, type, required, options).
- **find** — Matching text snippets with the heading path locating each.
- **site** — A host's agent-facing metadata: robots.txt summary (allow/disallow for a browser agent, crawl-delay, sitemaps) + llms.txt content + whether llms-full.txt exists. Context only — never blocks a fetch.
- **click** — match?, render? }
- **submit_form** — Submits a form from the current page (cookies carried); returns a summary. Forms declaring `enctype=multipart/form-data` are encoded as multipart automatically; `files` attaches uploads (`{field, filename?, mime?, content \
- **controls** — Non-link interactive controls (buttons, `role=button`, `onclick`/`tabindex`, submit/reset inputs, tabs, summaries), each with a stable CSS selector for `interact`.
- **interact** — Dispatches an interaction at a selector and runs the page's JS so its handlers fire, then returns the updated page. `event` defaults to `click`, which emulates a **full primary-button press** (`pointerdown`→`mousedown`→focus→`pointerup`→`mouseup`→`click`) so press/pointer-based widgets (react-aria/…
- **data** — Machine-readable structured data embedded in a page: JSON-LD (schema.org), HTML data tables (caption/headers/rows), and microdata (itemscope/itemprop). `kind` selects `jsonld`, `tables`, `microdata`, or `all` (default). HTML only. *(Tables: colspan and rowspan are expanded onto the real grid; micro…
- **extract** — Caller-directed structured extraction with a CSS-selector schema: `fields` maps each output name to a selector (a string takes the element's collapsed text; `{selector, attr}` takes an attribute value instead). An optional `root` selector emits one record per matching container (e.g. `root="li.prod…
- **requests** — The network requests the page's JavaScript made while rendering (fetch/XHR, scripts, modules, dynamic imports), each with method/url/status. The escape hatch for data-driven pages: render once, see the JSON endpoint the page fetched, then `read` it directly instead of scraping the hydrated DOM. Req…
- **console** — The page's captured console output (log/info/warn/error/debug) from its JavaScript render, in order — for debugging why a page rendered as it did (boot errors, failed data loads, framework warnings). `level` filters to one severity. Requires JavaScript (not exposed under `--disable-js`).
- **cookies** — Inspect or change a session's cookies, scoped to an origin (`url`, else the session's current page). `action=list` (default) returns the jar's cookies as name/value; `set` adds/updates the cookies you pass; `clear` expires them. Requires a session.
- **session** — list\
- **map** — Discover a site's URLs: harvests sitemap.xml (robots.txt + `/sitemap.xml`, following sitemap indexes) and crawls same-origin links breadth-first from the seed. Returns a bounded, de-duplicated list tagged `source=sitemap\
- **search** — Web search via the configured provider (SearXNG or Brave): ranked results (title, url, snippet). `site` restricts to one domain. Requires `--search-provider` (see [Search](#search)); not exposed otherwise.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What unblink does — unblink MCP server

The unblink MCP server gives an AI agent a pure-Go way to fetch and inspect web pages through MCP. It parses HTML, can execute page JavaScript with its built-in DOM engine, removes much of the navigation and presentation material surrounding the main content, and emits Markdown within a token budget. The result is intended for reading and extraction rather than visual browsing.

The server also exposes page structure and machine-readable content. Agents can inspect headings, links, forms, controls, semantic regions, JSON-LD, tables, microdata, network requests, console output, cookies, and detected repeating collections. It can discover URLs from sitemaps and same-origin links, and it can query SearXNG or Brave when a search provider is configured.

## How it works

A typical request fetches a URL, parses its HTML5 document, optionally runs JavaScript, and applies semantic reduction before returning the result. The `read` tool defaults to article content in Markdown, supports pagination with a cursor, and can instead return the complete page, visible text, or raw HTML. Raw HTML can be limited to a CSS selector, which is useful for forms, scripts, and server-rendered JSON that reduction may remove.

For dynamic pages, `requests` reveals the fetch and XHR calls made during rendering. An agent can then inspect a discovered endpoint directly instead of repeatedly scraping a hydrated DOM. `interact`, `click`, and `submit_form` support page actions, while sessions preserve state such as cookies across requests.

Returned web content is marked as untrusted, and hidden instruction text, comments, and image-beacon URLs are handled by the default safety features. These measures are described as defense in depth rather than a guarantee against indirect prompt injection.

## Setup and configuration

Install the binary with Go, use the published multi-architecture Docker image, download a release binary, or build from source. The project requires Go 1.25 or newer; its Makefile can automatically obtain the pinned toolchain. The server communicates over MCP stdio, so a client launches it as a subprocess.

Claude Code can register the executable with `claude mcp add`, while Claude Desktop uses an `mcpServers` configuration entry. JavaScript rendering is enabled by default. Pass `--disable-js` for a lighter static path, `--search-provider` to enable the `search` tool, and `--tls-mimic` for some basic TLS fingerprint checks. `--no-safe-output` disables the safe-output behavior.

## Tools and capabilities

- Read reduced articles, full pages, raw HTML, or visible text.
- Inspect page metadata, outlines, links, forms, controls, and matching text.
- Click controls, dispatch JavaScript interactions, submit forms, upload files, and manage sessions.
- Extract JSON-LD, tables, microdata, repeated collections, and CSS-selected records.
- Review JavaScript requests and console messages, inspect or set cookies, and map site URLs.
- Search through SearXNG or Brave when configured.

## Limitations and notes

The unblink MCP server does not provide screenshots, pixel-level inspection, layout geometry, or a visual rendering surface. Its JavaScript runtime is not equivalent to V8; complex bundles and content rendered through canvas, WebGL, or workers may not appear. It is also not designed to defeat interactive anti-bot systems such as Turnstile or server-side proof-of-work.

The server is best suited to reading, research, navigation, and structured extraction. A full browser remains the better fit for visual verification, end-to-end testing, and pages that require a real browser engine. Search is unavailable unless a provider is selected, and JavaScript can be disabled when server-rendered content is sufficient.

_Full upstream README: https://allmcps.com/mcp/unblink/readme_

