---
name: publish-artifact
description: Publish HTML/CSS/JS artifacts to 23artifacts as live, shareable sites, and build with the platform's pieces — brand themes, image asset libraries, shared realtime state (rooms), access control, and review threads. Use when the user asks to publish, host, deploy or share an artifact, page, deck or site, or wants one built on-brand or collaborative.
---

# 23artifacts

Publishes the artifact you're working on as a live website and returns a shareable URL — and gives you the pieces to make what you publish good: the user's real brand, their real screenshots, live shared state between viewers, and a place for people to comment on it.

## The connector

Everything here runs through the **23artifacts** MCP connector (`https://23artifacts.com/mcp`). If its tools aren't available, tell the user to add the connector once — they'll be walked through signing in the first time it's used.

## Read this first, in this order

**Before you design anything**, call `list_themes` and `list_assets`. If the user has a theme, on-brand should be the default outcome and not a lucky one; if they have a screenshot of the thing you're describing, use it instead of inventing a placeholder. This is the single biggest difference between output that looks generic and output that looks like theirs.

**Then publish.** The minimum is `publish_artifact { name, files }`.

## Guides

Each of these is a sibling file. Read the one that matches what you're doing — you don't need them all.

- **`publishing.md`** — the `files` array, slugs, organizations, versions, staging vs going live. Read before your first publish.
- **`decks.md`** — real presentation decks the recipient can edit and present themselves: the create/read/update workflow. Read before building any slide deck.
- **`deck-format.md`** — the deck document itself, field by field: every element type, the morph recipe, charts-lite rules, fx, layouts, fonts, column math. Read before authoring a deck's JSON so the first draft renders.
- **`themes.md`** — the user's brand as tokens, CSS, guidance and assets. Read before choosing any colours yourself.
- **`assets.md`** — the image library: real screenshots, logos, device frames. Read before inventing a placeholder.
- **`runtime.md`** — what works inside the artifact sandbox and what doesn't (no cookies, no storage, no `wss:`). Read before writing JavaScript that needs to persist or connect.
- **`rooms.md`** — shared state between viewers: votes, presence, live cursors, collaborative editing, with no backend. Read when more than one person interacts with the same page.
- **`access.md`** — public, private, email-gated, org-only. Read when the artifact isn't meant for everyone.
- **`large-sites.md`** — file trees too big to inline, and video up to 4 GB, via the REST API. Read when a publish won't fit in a tool call.
- **`managing.md`** — listing, version history, rollback, analytics, deletion.

Call `get_guide` with a topic name to read one, or read the resource directly if your client exposes them.