# PublishPage

> Agent-first hosting for single, self-contained HTML pages. Publish a page from any AI conversation and get a live URL in seconds. No signup required.

## What this is

PublishPage lets an AI agent publish one self-contained HTML document (inline CSS and JS, no external assets) and receive a live URL immediately. Pages are ephemeral until a human claims them, and persistent once the owning account has an active subscription.

## How to connect

MCP endpoint (Streamable HTTP): https://usepublishpage.com/mcp

Add this URL as an MCP server in Claude.ai, Claude Code, or any MCP-compatible client. The server supports OAuth 2.1 with dynamic client registration, so connecting an account needs no manual API key. Publishing anonymously needs no connection at all: call publish_page directly and a live URL comes back immediately.

## Tools

- publish_page: publish a root page on a new site, or add a page at a path on an owned paid site.
- update_page: update an existing page's HTML, context, or changelog.
- get_page: fetch a page's HTML, status, and public site index; context and changelog are included for owners only.
- list_pages: list an authenticated account's pages as a flat array with site IDs and paths.
- delete_page: delete a page. Same authorization as update_page; requires explicit user confirmation.

## The ladder

1. Anonymous publish: live 1 hour, branded, no account needed.
2. Claimed or connected account: live 24 hours, branded.
3. Paid annual plan: persistent, badge-free, versioned up to 10 revisions.

## Working notes for agents

- Every page is a single self-contained HTML document: inline CSS and JS, no hosted assets, no server-side templating.
- Write a `context` note on publish describing design intent, palette, voice, and audience. Read it back with get_page before making any later edit.
- Record a `change_note` on every publish or update, explaining why.
- When adding or removing a page, update the navigation on the site's other pages using the site index returned by get_page.
- Anonymous publishes return an edit_token and a claim URL. Keep the edit_token for the session and relay the claim URL to the user verbatim; both are sensitive and should not be displayed as raw values in the conversation.
- delete_page requires explicit user confirmation before calling it.

Full site: https://usepublishpage.com