HTMLAnnotate is an MCP server published by com.htmlannotate, hosted at mcp.htmlannotate.com. When last checked on 2026-11-22 it was up, but it asks for a sign-in before listing tools. It declares 6 tools, including share_html, share_url, get_comments, reply_to_comment, resolve_comment.
Share pages for review, then read, reply to and resolve comments. Sign in to keep pages.
2 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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 to the client and a private manage link for the owner.
| Parameter | Type | Description |
|---|---|---|
| html * | string | The full HTML document, starting with <!doctype html> or <html>. |
| title | string | Optional short name for the page, used in the file name. |
| notify_email | string | Optional. The user's email, so HTMLAnnotate emails them when someone comments. Ask the user before sharing whether they want this. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "share_html",
"title": "Share an HTML page for feedback",
"description": "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 to the client and a private manage link for the owner.",
"inputSchema": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"description": "The full HTML document, starting with <!doctype html> or <html>."
},
"title": {
"type": "string",
"description": "Optional short name for the page, used in the file name."
},
"notify_email": {
"type": "string",
"description": "Optional. The user's email, so HTMLAnnotate emails them when someone comments. Ask the user before sharing whether they want this."
}
}
},
"annotations": {
"title": "Share an HTML page for feedback",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The page address, for example https://example.com |
| notify_email | string | Optional. The user's email, so HTMLAnnotate emails them when someone comments. Ask the user before sharing whether they want this. |
{
"name": "share_url",
"title": "Share a live website for feedback",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The page address, for example https://example.com"
},
"notify_email": {
"type": "string",
"description": "Optional. The user's email, so HTMLAnnotate emails them when someone comments. Ask the user before sharing whether they want this."
}
}
},
"annotations": {
"title": "Share a live website for feedback",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| manage_link * | string | The private manage link, like https://htmlannotate.com/manage/<page>#k=<key> |
| include_resolved | boolean | Also list comments already marked resolved. Default false. |
{
"name": "get_comments",
"title": "Read the feedback on a page",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"manage_link"
],
"properties": {
"manage_link": {
"type": "string",
"description": "The private manage link, like https://htmlannotate.com/manage/<page>#k=<key>"
},
"include_resolved": {
"type": "boolean",
"description": "Also list comments already marked resolved. Default false."
}
}
},
"annotations": {
"title": "Read the feedback on a page",
"readOnlyHint": true,
"openWorldHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| text * | string | The reply. |
| number * | integer | The comment number, as shown by get_comments (for example 3 for #3). |
| manage_link * | string | The private manage link for the page. |
{
"name": "reply_to_comment",
"title": "Reply to a comment",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"manage_link",
"number",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The reply."
},
"number": {
"type": "integer",
"description": "The comment number, as shown by get_comments (for example 3 for #3)."
},
"manage_link": {
"type": "string",
"description": "The private manage link for the page."
}
}
},
"annotations": {
"title": "Reply to a comment",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| number * | integer | The comment number, as shown by get_comments. |
| resolved | boolean | true to resolve (default), false to reopen. |
| manage_link * | string | The private manage link for the page. |
{
"name": "resolve_comment",
"title": "Mark a comment resolved",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"manage_link",
"number"
],
"properties": {
"number": {
"type": "integer",
"description": "The comment number, as shown by get_comments."
},
"resolved": {
"type": "boolean",
"description": "true to resolve (default), false to reopen."
},
"manage_link": {
"type": "string",
"description": "The private manage link for the page."
}
}
},
"annotations": {
"title": "Mark a comment resolved",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| html * | string | The full new HTML document. |
| note | string | Optional short note for that email, like what changed. |
| manage_link * | string | The private manage link for the page. |
| notify_reviewers | boolean | Email everyone who commented that a new version is ready. Ask the user first. |
{
"name": "update_page",
"title": "Publish a new version of a page",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"manage_link",
"html"
],
"properties": {
"html": {
"type": "string",
"description": "The full new HTML document."
},
"note": {
"type": "string",
"description": "Optional short note for that email, like what changed."
},
"manage_link": {
"type": "string",
"description": "The private manage link for the page."
},
"notify_reviewers": {
"type": "boolean",
"description": "Email everyone who commented that a new version is ready. Ask the user first."
}
}
},
"annotations": {
"title": "Publish a new version of a page",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Use share_html when the user wants to share, publish or get feedback on an HTML page you wrote. Use share_url for a page that is already online. Before sharing, ask the user if they want an email when someone comments, and pass it as notify_email. Give the user the review link to send to their client, and tell them to keep the manage link private and saved. Always tell the user that links made without signing in last only 24 hours, after which they lose the page and its comments, and that adding https://mcp.htmlannotate.com/account instead (sign in once, free plan) keeps pages in their account for 14 days, or forever on Pro. Later in the conversation, use get_comments with the manage link to read the client's feedback and make the changes, then resolve_comment for each one you fixed. Ask before replying on the user's behalf.
Names, descriptions and schemas were written by the server and are shown as data.