html-mcp-web
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.
html-mcp-web
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.


What keeps the agent on track
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
Install
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.
Init
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.
Listen
To review, 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.
Reviewing
Select text on the rendered page and press the Comment button beside it. + Note comments on the whole artifact.
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.
Suggested edits
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.
Export to PowerPoint and PDF
Press PPTX in the topbar for an editable PowerPoint deck of the slides, or PDF to print every page.
On a tablet or phone

Use the port number in the review page address the agent gives you. 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>Configuration
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. |
Your own templates and guidelines
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.
See also
tex-mcp-web reviews a LaTeX paper from its PDF the same way, while the agent edits the source.
Acknowledgements
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
Maintenance
Related MCP Connectors
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.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceHuman-to-AI code review bridge. Annotate UI elements in the browser with review comments, and AI agents read the feedback via MCP to fix code automatically — with full element context (CSS selector, styles, DOM path, accessibility info). 10 MCP tools, framework-agnostic Web Component, zero-config install via uvx.9-
- FlicenseNot gradedqualityFmaintenanceEnables AI agents to publish HTML artifacts for human review, receive anchored feedback, and iterate until approval.2-
- AlicenseNot gradedqualityAmaintenanceLocal-first HTML review workspace for AI coding agents, enabling direct text and formatting edits, element comments, area annotations, and slide-aware review with durable agent handoffs.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables coding agents to publish HTML artifacts that users can review and comment on in a sandboxed browser viewer, with feedback loop support for iterative versions.10 npmMIT