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.

Just Publish

Links

README