ai.justpublish/just-publish

Official3 tools

by just-done

Just Publish

Publish the website you built with AI to a live public URL — straight from chat, no setup.

Deploy static websites to public URLs directly from conversational interface.

Topics

deploy-websitemcp-serverpublish-website

Captured live from the server via tools/list.

deploy

Publish a static site (HTML, CSS, JS, images) to a public URL. First call: omit site_id and edit_token — you'll get back a URL, site_id, and edit_token. Save the edit_token if the user wants to update the same site later. Subsequent calls: pass site_id + edit_token to update the same site in place — note that deploy REPLACES the entire file set (any file you omit is deleted). To change just one or a few files without resending the whole site, use update_site_file instead. To read what's currently live before editing, use get_site_files.

Parameters (4)

filesarrayrequired
Files to publish. Must include an index.html at the root.
emailstringrequired
Email to associate with the site. Captured unverified at first deploy; verification only required later for custom domains and recovery.
site_idstring
Existing site id to update. Omit to create a new site.
edit_tokenstring
Edit token returned at create time. Required to update.

get_site_files

Read the files of a site you previously published, so you can make a TARGETED edit instead of regenerating the whole site from memory. Returns: a complete manifest (every file's path, size, content-type, sha256) and the contents of the text files (HTML/CSS/JS/etc). Also returns the site's current `version` — pass it back to update_site_file to avoid clobbering a newer change. Pass `paths` to fetch only specific files; omit it to get all text files. Requires site_id + edit_token.

Parameters (3)

site_idstringrequired
The site id returned at publish time.
edit_tokenstringrequired
The edit token returned at publish time.
pathsarray
Optional. Specific file paths to return contents for (e.g. ['index.html','style.css']). Omit to get all text files. The manifest always lists every file regardless.

update_site_file

Update ONE OR A FEW files of an already-published site, leaving every other file untouched (MERGE — unlike deploy, which replaces the whole site). Ideal for small edits: fix a typo in index.html, swap a stylesheet, add one page. Best practice: call get_site_files first, edit the returned content, then call this with the files you changed and the `expected_version` from that read — if the site changed in the meantime you'll get a clear conflict telling you to re-read. Requires site_id + edit_token. Cannot delete files (use deploy to drop a file) and cannot remove index.html.

Parameters (4)

site_idstringrequired
The site id returned at publish time.
edit_tokenstringrequired
The edit token returned at publish time.
filesarrayrequired
The files to change. Only these are written; all other files on the site survive.
expected_versioninteger
Optional but recommended. The `version` you got from get_site_files. If the site has changed since, the update is rejected with a conflict so you can re-read and re-apply. Omit to force last-writer-wins.

README.md3 KBView on GitHub

Just Publish — MCP Server

Publish the website you built with AI to a live public URL — straight from chat, 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. No git, no CLI, no build step, no dashboard, and no login to fumble through. 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

json

{
  "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; `edit_token` is the only auth.

Plus a UI resource for the publish-result widget.

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

No accounts required. Edit access is held by the edit_token returned at publish time — save it to update the site later.
Static sites only — files in, URL out. No frameworks or build pipelines.
Free to start; a Builder plan and custom-domain connection are available 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.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "just-publish": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.justpublish.ai/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.