Give your agent
a safe way to publish.
Connect once and ask your agent to share a file. Send HTML or Markdown directly—no base64 conversion, local server, account, or API key is required for Free publishing.
Last updated
Connect once. Then ask for a link.
https://html2web.iill.dev/mcpConnect your agent
Choose the app you already use. Cursor and VS Code open the reviewed connection inside the app; terminal clients use one copyable command.
Connect in Codex
Paste this in a terminal, then restart the current Codex session if the tools do not appear immediately.
codex mcp add html2web --url https://html2web.iill.dev/mcpConnect in Claude Code
Paste this in a terminal. The user scope makes HTML2WEB available in every project.
claude mcp add --transport http --scope user html2web https://html2web.iill.dev/mcpConnect in Cursor
Open Cursor, review the html2web remote server, then approve it. No local server package is installed.
Open in CursorCursor did not open? Copy the global config
Add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"html2web": {
"url": "https://html2web.iill.dev/mcp"
}
}
}Connect in VS Code
Open VS Code, review the HTTP server configuration, and confirm the trust prompt.
Open in VS CodeVS Code did not open? Copy the user config
Run MCP: Open User Configuration, then add this server.
{
"servers": {
"html2web": {
"type": "http",
"url": "https://html2web.iill.dev/mcp"
}
}
}Publish your first page
Attach or point your agent to an HTML or Markdown file, then send this prompt. The agent reads the source locally; HTML2WEB does not access your filesystem.
Share this file as a browser link for 1 hour.
Done looks like: public URL, expiry time, password status, and what was actually checked. Private ownership keys stay out of ordinary chat.
Writing your own client? One tool call is enough
Call publish_share with the original UTF-8 source. The filename selects the format. Generate a random request key once and keep it for retries; do not reuse this example key.
{
"content": "# Review notes\n\nReady to share.",
"filename": "review-notes.md",
"idempotencyKey": "replace-with-one-random-request-key"
}Return url to the recipient. Keep manageToken, manageUrl and creatorPreviewUrl private. A retry with the same key returns the same URL without recovering those keys.
Retry protection applies to the same caller identity while its request record remains valid, for up to 24 hours. Anonymous IP or UTC-day changes can change that identity. Do not assume a delayed retry or a changed network will be deduplicated.
Install the Agent Skill
MCP works without this extra installation. Add the skill if you want compatible agents to follow the same source-checking, retry, verification, and private-link workflow.
Publishes and manages the link.
Guides safe, consistent tool use.
npx skills add https://html2web.iill.dev --skill publish-html2web --global --yesOnly want it in the current project?
npx skills add https://html2web.iill.dev --skill publish-html2web --yesThe skill is readable before installation. Review the official SKILL.md →
Available tools
- publish_share
- Recommended: share HTML or Markdown source directly. A filename selects the format; no base64 is needed.
- get_publish_limits
- Check this connection’s file-size and active-link limits, expiry choices, and availability without using publishing quota.
- publish_html
- Compatibility: publish an HTML string.
- publish_markdown
- Compatibility: render and publish a Markdown string.
- publish_html_file
- Compatibility: publish base64-encoded UTF-8 HTML or Markdown.
- update_share
- Replace content on the same URL. Pass the current contentVersion as expectedContentVersion to avoid overwriting newer changes.
- delete_share
- Delete the share immediately.
- set_password
- Add, change, or remove viewer protection.
- set_expiry
- Change the expiry within the current plan.
- get_share_status
- Read status and contentVersion without retrieving source or recording an open.
Management tools accept the public URL in slug. For links owned by the connected Pro account, no manage token is needed. Anonymous links still require their private ownership key.
Free limits
Up to 1 MiB (1,048,576 UTF-8 bytes) per file, with 30-minute, one-hour, or 24-hour expiry. Temporary operating restrictions can narrow these choices; get_publish_limits reports the current policy.
Quota errors include a reset time or retry delay. Other errors explain the next action. Never silently truncate a file, retry with a new key to bypass limits, or recreate an expired link without asking.
Reconnect with Pro OAuth
Pro uses a separate protected endpoint. Your MCP client handles OAuth; you never create, copy, or paste an API key.
https://html2web.iill.dev/mcp/pro- Open the HTTPS upgrade URL returned with the Free quota error.
- Sign in with Google or GitHub, then complete checkout in the browser.
- Wait until the verified subscription is active on your HTML2WEB account.
- Add or reconnect the Pro endpoint above and finish the browser authorization prompt.
Publishing receives Pro quota only after the subscription webhook is verified and the MCP connection is authorized for that account.
If checkout is unavailable, keep using Free or contact@iill.dev. Signing in alone does not activate Pro, and a link-credit pack alone does not unlock the Pro MCP endpoint.
If your client cannot open upgrade links
Copy the upgradeUrl from the tool result into a normal browser. Complete sign-in and checkout there, then add the Pro endpoint as a new Streamable HTTP connection. If the client still uses the public Free endpoint, remove that stale connection and reconnect—do not paste a bearer token or checkout URL into the MCP configuration.
Manage tokens are ownership keys
A first publish response contains a manage token for later changes. Your MCP client and agent receive this private key; it is not an API key and is never needed to view the page. Keep it out of public channels, ordinary chat and analytics. Only save it when the user requests private storage in an appropriate secret store.
Inspect source for passwords, API keys, personal data, or tokens before publishing. The viewer is isolated, but the shared page is reachable by anyone who has its URL unless you set a password.