# Just Publish [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/just-done/just-publish-mcp  
**GitHub Stars:** 1  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/just-publish-2

## Description
Publish a static website to a live public URL straight from chat.

## Tools
Capabilities this server exposes over MCP:

- **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`.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "just-publish": {
    "url": "https://mcp.justpublish.ai/"
  }
}
```

## Documentation & README

# 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

```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. |

## Agent Skill (ChatGPT / Codex / any SKILL.md runtime)

This repo also hosts the **`just-publish` Agent Skill**, a [SKILL.md-format](https://learn.chatgpt.com/docs/build-skills)
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](https://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](https://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](https://github.com/just-done/just-publish-mcp/blob/HEAD/LICENSE).