Publish a new page
publish_pagePublish a new HTML (or Markdown) page to the maker's PubSpace space and get back a live, shareable URL to hand to the human. Pages are unlisted by default — indexed by search engines only if the maker turns that on later (Pro); anyone with the link can view. Use this only for a brand-new page; to change a page that already exists, call update_page so its URL stays the same (find the id with list_pages). Each call creates a page that counts toward the plan's live-page cap; at the cap the call fails with doc_limit_reached and, on the free plan, an upgrade link to relay to the human. Content that looks like live credentials (API keys, private keys, .env lines, database URLs with passwords) is refused with secrets_detected and the line numbers; remove them and retry. A page that works as a sign-in or payment form sending what people type to another site can be refused with unsafe_page_detected (no override): make such forms non-functional demos. Returns { url, id, mode, visibility, dashboardUrl }. Connected without an API key, it publishes a 7-day preview at a pubspace.page link instead (no account needed, up to 5 MB, no password, stricter sign-in lookalike check) and returns { url, id, mode, preview: true, expiresAt, claimToken, tell_user }: relay tell_user, and keep claimToken, the only way to change that page later (update_page with claim_token). Pass claim_token to add another page under the same token (up to 5 live previews). Later publishes in the same session join the first preview's token and do not return claimToken again: that first token covers them. To keep previews for good, call claim_page with the human's email.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"html": "<html>"
},
"name": "publish_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| html | Yes | Full HTML document (or Markdown when source_type is "markdown"), up to 15 MB on the free plan and 20 MB on Pro, so self-contained pages with embedded images fit; a free account's pages and drafts total up to 100 MB (past that: storage_limit_reached). Served byte-faithful apart from documented meta/bar injections. Over 5 MB the result adds a sizeNote with tips to shrink it. | |
| title | No | Optional title (used in the dashboard and social cards). | |
| project | No | Optional: which body of work this page belongs to (e.g. "Q3 board pack"). Groups pages in the maker's library — reuse their existing project names from list_pages when one fits. (Renamed from `product` in v0.16.0; the old name is still accepted.) | |
| claim_token | No | Keyless previews only: the claimToken from an earlier preview, to add this page under the same token. Ignored when connected with an API key. | |
| source_type | No | Default "html". |