This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Review an AI agent's HTML slides or report from the rendered page, on a desktop, tablet, or phone, while Claude Code or Codex edits the source. Hand the finished slides over as an editable PowerPoint deck.
⭐ If this helps your reviews, please give it a star. It helps others find the project.
It reads the rules, and reads them again. In Claude Code, html-mcp's tools stay locked until the agent has read the template's rules and the writing guideline in full, and they lock again after every compaction. A long session keeps working from the rules, not from a fading memory of them.
It fixes its own layout. The way a programmer works through compiler errors, the agent checks each page it changes, gets a plain list of layout faults such as text spilling out of its box or a last line left nearly empty, fixes them, and checks again before you look.
Related MCP server: Terrarium
Paste this into Claude Code or Codex:
Install html-mcp-web by following https://raw.githubusercontent.com/MiiKiyoshi/html-mcp-web/main/INSTALL.mdThe agent checks for Python and Firefox, shows you what it will install, and installs once you agree. Start the agent again afterwards.
Once per folder, start the agent in the folder that holds (or will hold) your artifact and say:
do html initChoose slides (16:9) or a report (A4). Slides default to the neutral-slides template, plain
slides without organization marks, and the neutral-slides guideline, writing rules the agent
follows for slides. Reports default to the neutral-report template, a two-column paper, and
the neutral-report guideline, writing rules for a paper. The agent
shows the choices and the document file it will create or reuse. Accept the defaults or name
what to change.
With the plugin installed, a recent Claude Code, one that runs plugin monitors, needs no
command: a session started in the folder listens for Call agent for as long as it runs,
however long the page sits idle. Open http://localhost:<port> in your browser, with the
port in .html-mcp-web.yaml. In Codex, or in a Claude Code without plugin monitors, say:
do html listenThe agent gives you the review page address, such as http://localhost:8765, and gets ready
to handle your comments when you press Call agent. Open that address in your browser. Say
do html listen again after the agent restarts.
Presses go to one session per folder. A Claude Code session that starts while another listens
leaves the presses to it, and do html listen in any session moves them there.
Select text on the rendered page and press the Comment button beside it. + Note comments on the whole artifact.
Source beside Comment selects the same words in the source editor, a formula by the TeX KaTeX keeps for it. The other way, → Preview beside + Comment in the editor's bar marks the selected source words on the page. Either turns the view to Split.
The box tool, beside the search button over the artifact, turns a drag on a page into a box to comment on what has no text to select, such as part of a figure. The agent reads the box in page pixels and can look at just that part.
Press Call agent when your comments are ready. The agent edits the source and replies in the same thread.
Resolve a thread whose edit satisfies you, or Reply in it when it does not. Archive sets a thread aside, and it still takes replies.
The thread shows the source the agent would change as a −/+ pair, and the Source view marks the same text in red. Apply suggestion writes the change into the file. Proposing again replaces the proposal.
The Vim button in the editor's bar turns on Vim keys, and the page remembers the choice.
:w saves. jj typed quickly, Escape or Ctrl+[ leaves Insert mode.
gc comments on the text a motion or a visual selection covers, and gs marks that text
on the page.
K opens the comment under the cursor in the comment list.
A yank also goes to the system clipboard.
With or without Vim keys, Ctrl+S saves, Ctrl+Alt+M comments on the selection, Ctrl+Alt+P marks it on the page, and Ctrl+Alt+K opens the comment under the cursor. Ctrl+Alt+Enter presses Call agent. On macOS, Cmd takes the place of Ctrl and Option of Alt in these. Ctrl+[ drops a comment being written, with Ctrl on macOS too.
A browser extension that drives pages with Vim keys takes Escape and Ctrl+[ before the editor does and moves the focus out of it, which leaves the editor in Insert mode. Turn the extension off for the review page's address.
Press PPTX in the topbar for an editable PowerPoint deck of the slides, or PDF to print every page.
Use the port number in the review page address, the port in .html-mcp-web.yaml. Forward
that port over SSH from Termux on Android or iSH on iOS, then open the same address in the
phone's browser.
ssh -L <port>:localhost:<port> <server>Edit .html-mcp-web.yaml in the project folder. A saved change applies at once, except
port, which applies when Claude Code or Codex restarts.
artifacts:
slides:
label: Slides
layout: slides
main: slides.html
watch:
- '*.html'
- '*.css'
- '*.js'
- '*.svg'
- '*.png'
- '*.jpg'
- '*.jpeg'
- '*.gif'
- '*.webp'
ignore: []
port: 8765Field | Effect |
| Name the review page shows for the artifact. |
|
|
| The HTML file the page shows. Each artifact keeps its |
| A template name and the content file it builds |
| A writing guideline the agent follows, such as the built-in |
| Files whose saves refresh the page. |
| Patterns excluded even when they match |
| This folder's review page port. Any free port works. Init picks the first free one from 8765, so each folder can have its own. |
Put a template in ~/.config/html-mcp-web/templates/<name>/. Start from a copy of
templates/neutral-slides, as templates/SKINS.md explains. Put a
writing guideline for the agent in ~/.config/html-mcp-web/guidelines/<name>/GUIDELINE.md.
To build on a built-in guideline, neutral-slides
or neutral-report, instead of copying it, open your
file with this front matter, write only the rules you add or change, and say that yours win
where the two differ:
---
extends: neutral-slides
---A name you use replaces the built-in one of the same name. do html init offers both.
tex-mcp-web reviews a LaTeX paper from its PDF the same way, while the agent edits the source.
MIT licensed. See LICENSE. The source editor uses Ace under the BSD license, and its license is included with the bundled files. Full-screen wheel navigation adapts the intent-detection strategy from Swiper's Mousewheel module by Vladimir Kharlampidi and the Swiper contributors, under the MIT license.
This server cannot be deployed
Human feedback for AI agents: share HTML, get a live review link, read anchored notes as markdown.
Human visual review for agent-built HTML: publish artifacts, pull anchored comments, push fixes.
Comment on AI-generated webpages; feedback flows back to your coding agent. Free, MIT, local-first.
Agents publish self-contained HTML to a stable review link, with page-level feedback and revoke.
