# webEmbedding

> webEmbedding is an open-source MCP server for developer tools. MCP server that clones a web page from its URL into a verified offline HTML copy. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/jongko54/webembedding
- **MCP Registry name:** io.github.jongko54/web-embedding
- **Categories:** developer tools, browser automation
- **Listing updated:** 2026-11-15

## About

WebEmbedding picks the least invasive route for each page. If the page can be embedded, it returns the original embed. Otherwise it captures the live page with Playwright and produces a self-contained HTML snapshot with inlined CSS, shadow DOM and localised fonts and images, or a bounded rebuild when reuse is blocked, for example by X-Frame-Options or CSP headers.

What sets it apart is self-verification. Results are scored against desktop, tablet and mobile screenshots of the live page, along with DOM, computed-style and hover, focus and click interaction checks. The README reports local benchmarks where runtime snapshots of pages like MDN and lit.dev scored 95 to 99, taking roughly 34 to 226 seconds. It also reports typed failure codes such as auth-session-missing and canvas-visual-fallback.

The README is clear about limits: it suits static and semi-static pages, and is not a backend clone engine. Login-only apps, captcha sites, maps, games, canvas or WebGL pages, real-time feeds, payments and booking flows need separate handling. It needs Node 18, Python 3.9 and a local Chrome or Chromium. A hosted Apps SDK endpoint exposes lighter routing tools.

## Features

- **Source-first routing:** Reuses an embed or original source before rebuilding.
- **Offline HTML snapshot:** Inlines CSS, shadow DOM, fonts and images into one file.
- **Visual verification:** Scores clones against desktop, tablet and mobile screenshots.
- **Blocked-page rebuild:** Rebuilds pages that refuse framing from captured evidence.
- **Failure classification:** Reports typed codes for auth, replay and canvas limits.
- **Job queue and HAR replay:** Queues clone jobs and audits recorded network evidence.

## Good for

- Clone a public landing page into a local folder
- Get an embed snippet for a page that allows framing
- Archive a documentation page as offline HTML
- Check a clone's fidelity at mobile and tablet widths

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http web-embedding https://webembedding-jongkos-mcp.vercel.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://webembedding-jongkos-mcp.vercel.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "web-embedding": {
      "url": "https://webembedding-jongkos-mcp.vercel.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "web-embedding": {
      "type": "http",
      "url": "https://webembedding-jongkos-mcp.vercel.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "web-embedding": {
      "serverUrl": "https://webembedding-jongkos-mcp.vercel.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "web-embedding": {
      "type": "http",
      "url": "https://webembedding-jongkos-mcp.vercel.app/mcp"
    }
  }
}
```

## FAQ

### What can it not clone?

Backend logic, login-only apps, captcha sites, maps, games, canvas or WebGL pages and payment flows.

### What does it need locally?

Node.js 18, Python 3.9 and Chrome or Chromium.

### How is quality measured?

With screenshot, DOM, computed-style and interaction comparisons across desktop, tablet and mobile.

### Is there a hosted version?

A hosted Apps SDK endpoint offers lighter routing and embed tools.

### Is webEmbedding free?

Yes. webEmbedding is open source, so you can use and self-host it for free.

### How do I add webEmbedding to Claude Code?

Run this command in your terminal: claude mcp add --transport http web-embedding https://webembedding-jongkos-mcp.vercel.app/mcp

### What are the best alternatives to webEmbedding?

The closest alternatives to webEmbedding are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/webembedding
