Just Publish MCP Server
Publish the website you built with AI to a live public URL, straight from chat, with no setup.
Describe a site to your AI assistant (ChatGPT, Claude, Gemini, or any MCP-enabled client) and it publishes the site and hands back a live URL. You hand it your files, it hands back a working link. Built for the person who made a site with AI and just wants it online.
- Website: https://justpublish.ai
- MCP endpoint:
https://mcp.justpublish.ai/ - Registry name:
ai.justpublish/just-publish - Transport: Streamable HTTP (remote, nothing to install)
How it works
Call deploy with your files (HTML, CSS, JS, images) and an email. You get back a
live url, a site_id, and an edit_token. Keep the token and you can update the
same site anytime, either a full redeploy or a single-file edit. That's the whole
flow.
Connecting
{
"mcpServers": {
"just-publish": {
"type": "streamable-http",
"url": "https://mcp.justpublish.ai/"
}
}
}
Then ask your assistant to publish a site. It returns the public URL.
Tools
| Tool | What it does |
|---|---|
deploy | Publish a new static site (HTML/CSS/JS/images), or fully replace an existing one. Returns the live URL, a site_id, and an edit_token. |
get_site_files | Read a published site's files so the assistant can make a targeted edit. Requires site_id + edit_token. |
update_site_file | Change one or a few files in place (merge). Requires site_id + edit_token. |
Resources
Static markdown guidance the client can load into context before it picks a tool:
| Resource | Purpose |
|---|---|
just-publish-overview | What Just Publish is and which tool to use when. |
just-publish-edit-lifecycle | The read β edit β update loop. |
just-publish-file-conventions | Paths, encoding, size limits, routing. |
just-publish-invariants | index.html required; deploy replaces vs. update_site_file merges. |
Agent Skill (ChatGPT / Codex / any SKILL.md runtime)
This repo also hosts the just-publish Agent Skill, a SKILL.md-format
package that teaches an agent the full publish flow (including saving the
edit_token and the email-verification step) before it ever calls a tool.
To install in Codex / ChatGPT, ask the assistant to install the skill from this tree:
https://github.com/just-done/just-publish-mcp/tree/main/skills/just-publish
(Codex's skill-installer takes a GitHub tree URL.) For a manual install, copy
skills/just-publish/ into $CODEX_HOME/skills/ (default ~/.codex/skills/)
or your runtime's equivalent (e.g. ~/.claude/skills/).
The same package is served for discovery scanners and other runtimes at justpublish.ai/.well-known/agent-skills/index.json (Agent Skills Discovery RFC, sha256-digested). The canonical source lives in the Just Publish server codebase; this tree is its published mirror and is kept in lockstep. The two are compared on every server deploy.
Who it's for
Non-technical builders and AI agents that generate a static site and need it hosted in one step. If you can describe a page, you can publish it.
Good to know
- Static sites only. Files in, URL out. No frameworks or build pipelines.
- Custom domains. Connect your own domain at justpublish.ai.
About this repository
Public metadata + registry listing for the Just Publish MCP server: server.json,
.mcp.json, icons, and this README. The server runs at
https://mcp.justpublish.ai/; its source is not part of this repo.
License
MIT. See LICENSE.