# HTMLAnnotate

> HTMLAnnotate is a freemium MCP server for design and media. Turn a page your AI wrote into a review link, then read and resolve the comments. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $8 a month
- **Platforms:** Web, API
- **Website:** https://htmlannotate.com/mcp
- **MCP Registry name:** com.htmlannotate/htmlannotate
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

The workflow runs both ways. An assistant publishes an HTML page it just wrote, or a live website or staging link, and returns two links: a review link for your client and a private manage link for you. Later it can read each comment with the element and selector it is pinned to, reply, apply the requested changes and mark comments resolved. It can also publish a new version on the same review link.

No account or API key is needed. The tradeoff is life span: links made through the connector last 1 day for now, and the connector cannot delete pages or see pages it lacks the manage link for. Signing up free keeps pages for 14 days and Pro keeps them forever. Sign-in through MCP, so the assistant can see all your projects, is listed as coming next.

If you give an email when sharing, HTMLAnnotate emails you when comments arrive. Install steps are given for Claude Code, Codex, Gemini CLI, VS Code, Cursor, Windsurf, Claude and ChatGPT.

## Features

- **Share generated pages:** Publishes an HTML page the assistant wrote and returns a review link.
- **Review live sites:** Creates a review link for an existing site or staging URL.
- **Read comments:** Reads comments with the element and selector each is pinned to.
- **Reply and resolve:** Replies to comments and marks them resolved.
- **New versions:** Publishes the next version on the same review link.
- **No sign-in:** Works without an account or API key.

## Good for

- Send a client a review link for a landing page the AI built
- Collect feedback on a Vercel preview or staging site
- Have the AI apply a client's comments and mark them done
- Re-share a revised page on the same link

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http htmlannotate https://mcp.htmlannotate.com
```

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

```sh
https://mcp.htmlannotate.com
```

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

```json
{
  "mcpServers": {
    "htmlannotate": {
      "url": "https://mcp.htmlannotate.com"
    }
  }
}
```

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

```json
{
  "servers": {
    "htmlannotate": {
      "type": "http",
      "url": "https://mcp.htmlannotate.com"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "htmlannotate": {
      "serverUrl": "https://mcp.htmlannotate.com"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "htmlannotate": {
      "type": "http",
      "url": "https://mcp.htmlannotate.com"
    }
  }
}
```

## Tools

- `share_html`: Publish a complete HTML page (for example a landing page, prototype or one-pager you just wrote) to HTMLAnnotate and get a review link. Anyone with the link can open the page and click any heading, button or image to leave a comment pinned to it, with no account. Pass the whole page as one self-contained HTML document (inline the CSS; images as URLs or data URIs). Returns the review link to send t
- `share_url`: Turn a public web address (a published site, staging link or deploy preview) into an HTMLAnnotate review link where people click any element and comment on it. The page must open in a browser without signing in.
- `get_comments`: Read every comment on an HTMLAnnotate page: what each reviewer said, which element it is pinned to (with a CSS selector), the screen size, the page version it was left on, suggested text changes and replies. Use it when the user asks what their client said, or wants you to make the requested changes. Needs the page's private manage link (returned by share_html or share_url, or pasted by the user).
- `reply_to_comment`: Post a reply under one comment on an HTMLAnnotate page, as the page owner. Everyone in that thread gets an email. Confirm the wording with the user first.
- `resolve_comment`: Mark a comment on an HTMLAnnotate page as resolved (done), or reopen it. Use after the requested change has been made. Everyone in the thread gets an email when it is resolved.
- `update_page`: Replace an HTML page on HTMLAnnotate with a new version, on the same review link, so the client sees the update without a new link. The new version starts with no comments; earlier versions keep theirs. Use after making the changes from get_comments. Needs the manage link. Only for pages shared as HTML, not live websites.

## FAQ

### Do I need an account?

No. The connector needs no account or key.

### How long do links last?

Links made through the connector last 1 day for now; a free account keeps pages 14 days, Pro keeps them forever.

### What can it not do?

It cannot delete pages or see pages it has no manage link for.

### How do I find comments later?

Keep the private manage link; in a new chat, paste it so the assistant knows which page.

### Is HTMLAnnotate free?

HTMLAnnotate has a free plan, with paid plans for more usage or features. Paid plans start at $8 a month.

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

Run this command in your terminal: claude mcp add --transport http htmlannotate https://mcp.htmlannotate.com

### What are the best alternatives to HTMLAnnotate?

The closest alternatives to HTMLAnnotate are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [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.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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