tag and og:title. Site-level: applied as a default to pages that don't set their own."},"robots":{"enum":["index","noindex"],"type":"string","description":"Search-engine indexing directive. `noindex` keeps the page out of Google."},"description":{"type":"string","maxLength":500,"minLength":1,"description":"Meta description. Used in <meta name=\"description\">, og:description, and twitter:description."},"og_image_url":{"type":"string","format":"uri","description":"Public URL for the OpenGraph share image. Use `upload_image_from_url` or `upload_image_from_data` to host one if you don't have a stable URL."}},"description":"SEO fields to set. Only the provided fields are updated; omitted fields are left untouched.","additionalProperties":false},"site_id":{"type":"string","format":"uuid","description":"The site UUID to update SEO for."},"page_slug":{"type":"string","maxLength":200,"minLength":1,"description":"Page slug to update (e.g. `/about`). When omitted, applies the SEO values as site-wide defaults that fall through to pages without their own overrides."}},"additionalProperties":false}},{"name":"generate_sitemap","title":"Map site for search engines","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Build a sitemap.xml from a site's currently published version. Walks enabled pages and emits one <url> entry per page using the site's live URL (custom domain when verified, otherwise the *.sitelas subdomain). Returns the raw XML plus a parsed entries array. Read-only — does not mutate the site. Sitelas may already auto-serve a sitemap; use this tool to inspect or copy the generated XML.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"The site UUID to build a sitemap for."}},"additionalProperties":false}},{"name":"record_decision","title":"Record decision","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Append a durable decision (with optional rationale) to the site's cross-session memory. Use this whenever you make a non-obvious creative or structural choice the user might want to revisit later — palette swap, copy direction, layout approach, etc. Capped at 50 entries per site (oldest dropped). Returns the new total count and the timestamp recorded.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","decision"],"properties":{"why":{"type":"string","maxLength":500},"site_id":{"type":"string","format":"uuid"},"decision":{"type":"string","maxLength":500,"minLength":1}},"additionalProperties":false}},{"name":"update_site_brief","title":"Update site brief","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Set or incrementally update the durable site brief (vibe, category, brand voice, palette/font names, tagline, target audience) used as cross-session memory. Merges field-by-field into the existing brief — omitted fields are preserved, and the decisions[] log is left untouched. Call this once after picking a direction, then again whenever the direction shifts.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","brief"],"properties":{"brief":{"type":"object","properties":{"vibe":{"type":"string","maxLength":500},"tagline":{"type":"string","maxLength":500},"category":{"type":"string","maxLength":500},"font_pair":{"type":"string","maxLength":500},"brand_voice":{"type":"string","maxLength":500},"palette_name":{"type":"string","maxLength":500},"target_audience":{"type":"string","maxLength":500}},"additionalProperties":false},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_content_types","title":"List content types","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List every content collection declared on a site, with its per-item field schema (`fields[]`). Schemas are per-site — there is no platform-wide catalog. Each entry includes the collection's `contentType` slug, its `pathPrefix`, whether it's enabled, and the typed `fields[]` (each with `key`, `type`, optional `required`, `label`, `description`, `options` for select fields), PLUS `observed_fields` — keys that actually appear on the collection's items but aren't in the declared schema (the schema is open, so include these when adding an item so it matches the existing ones). Call this before `add_content_item` to discover which fields a collection supports — or before `create_collection` to confirm a contentType isn't already taken.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"Site whose collection catalog to list. Each site has its own schemas — there is no platform-wide catalog."}},"additionalProperties":false}},{"name":"create_collection","title":"Create collection","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Stand up a new collection on an existing site in one call: append a `collections[]` entry (with `contentType`, `pathPrefix`, `template`, and optional `items[]`), optionally create the index page that hosts the matching `<collection-list>`, and seed initial items into the `content_items` table. After this call:\n - `/{path_prefix}/{slug}` resolves each item via Mustache substitution\n - the index page's `<collection-list>` iterates the seeded items\n - `add_content_item` / `edit_content_item` / `delete_content_item` manage rows afterward.\n\nUse this when the user asks 'add a blog to my site', 'set up case studies', 'add a careers section', etc. Schemas are per-site — pick a `contentType` slug that's unique within the site (call list_content_types to see what's already declared) and ship the `fields[]` schema inline. Writes a new draft version; call publish_site to push live.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","path_prefix","fields","template"],"properties":{"items":{"type":"array","items":{"type":"object","required":["slug","content"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1},"content":{"type":"object","additionalProperties":{}},"visibility":{"enum":["public","private"],"type":"string"}},"additionalProperties":false},"description":"Initial items to seed into content_items. Each row's content must satisfy the collection's `fields` (required fields populated, declared types matched). The index page's <collection-list> will iterate these."},"fields":{"type":"array","items":{"type":"object","required":["key","type"],"properties":{"key":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]*$","maxLength":80,"minLength":1},"type":{"enum":["text","textarea","rich-text","number","boolean","url","date","image","tags","select"],"type":"string"},"label":{"type":"string","maxLength":120},"default":{},"options":{"type":"array","items":{"type":"string"}},"required":{"type":"boolean"},"maxLength":{"type":"integer","exclusiveMinimum":0},"description":{"type":"string","maxLength":400},"placeholder":{"type":"string","maxLength":200}},"additionalProperties":false},"minItems":1,"description":"Per-item field schema. Each field becomes a form input AND a write-time validation rule. Include every field the `template` references (placeholders like {{title}}, {{body}}, {{image.url}} map to field keys). The schema is per-site and per-collection — there is no global catalog."},"enabled":{"type":"boolean","description":"Defaults to true. Set false to ship the collection definition (template + items) without serving detail URLs or rendering index iteration."},"site_id":{"type":"string","format":"uuid"},"template":{"type":"object","description":"Per-item template Node tree with {{field}} placeholders. The template is rendered for each detail URL with the row's content substituted in. See the canonical examples in lib/fixtures/templates/hatch.json, prive.json, narrative.json for the shape.","additionalProperties":{}},"index_page":{"type":"object","required":["slug","title","tree"],"properties":{"slug":{"type":"string","pattern":"^\\/[a-z0-9-]+$","description":"Slug for the index page (the listing page that hosts the <collection-list>). Typically the path_prefix without the trailing slash, e.g. '/blog'."},"tree":{"type":"object","description":"Index page Node tree, which should contain a <collection-list contentType=...> primitive whose first child is the per-row card template.","additionalProperties":{}},"title":{"type":"string","maxLength":200,"minLength":1}},"description":"Optional index page to create at the same time. If the site already has an index page at the prefix (e.g. /blog), omit this and patch its tree separately.","additionalProperties":false},"path_prefix":{"type":"string","pattern":"^\\/[a-z0-9-]+\\/$","description":"URL prefix for detail pages. Single segment, kebab-case, with leading and trailing slashes. Examples: '/blog/', '/projects/', '/searches/', '/case-studies/'."},"content_type":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","maxLength":100,"minLength":1,"description":"The collection's per-site identifier (its content_type slug). Lowercase kebab-case. Each site owns its catalog — pick whatever name fits the brief (project, blog, recipe, episode, gift, …)."}},"additionalProperties":false}},{"name":"list_content_items","title":"List content items","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List content items (e.g. blog posts, projects) for a site filtered by content_type slug. Optionally filter by visibility ('public' | 'private' | 'all'; default 'all'), with limit/offset paging. Returns each item's id, slug, full content JSON, visibility, and timestamps. Use add_content_item / edit_content_item / delete_content_item to mutate the collection.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type"],"properties":{"filters":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0},"visibility":{"enum":["public","private","all"],"type":"string","default":"all"}},"additionalProperties":false},"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1}},"additionalProperties":false}},{"name":"add_content_item","title":"Add to collection","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"$76","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","slug","content"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Single-segment kebab-case slug (lowercase alphanumeric + dashes, no slashes, no leading/trailing dashes). The DB enforces this via a CHECK constraint; invalid slugs are rejected at insert time."},"content":{"type":"object","additionalProperties":{}},"site_id":{"type":"string","format":"uuid"},"visibility":{"enum":["public","private"],"type":"string","default":"public"},"content_type":{"type":"string","minLength":1},"published_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp used as the item's `publishedAt` for ordering. Defaults to now if omitted (and left untouched if `content.publishedAt` is already set). Sort a collection-list newest-first with sortBy:'publishedAt', sortDir:'desc' — more reliable than created_at, which can tie on bulk/automated inserts."}},"additionalProperties":false}},{"name":"edit_content_item","title":"Edit content item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Update fields on an existing content item. Identify it by `item_id`, OR — when you only know its name — by `site_id` + `content_type` + (`slug` | `title`); `title` resolves fuzzily (exact then contains) and errors with the available titles when there's no unique match. `patch` may include `content` (shallow-merged into existing content JSON), `slug` (rename), and/or `visibility`. At least one field is required. When `content` is patched, the MERGED result is validated against the content_type schema (lenient: required present + declared types; extra fields allowed) and rejected with paths if it would leave the item missing a required field. Ownership is verified via the parent site's user_id. Throws on slug collision.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["patch"],"properties":{"slug":{"type":"string","description":"Exact item slug to resolve (with site_id + content_type)."},"patch":{"type":"object","properties":{"slug":{"type":"string","maxLength":200,"minLength":1},"content":{"type":"object","additionalProperties":{}},"visibility":{"enum":["public","private"],"type":"string"}},"additionalProperties":false},"title":{"type":"string","description":"Item title to resolve fuzzily (case-insensitive exact, then contains). Errors with the available titles if there's no unique match."},"item_id":{"type":"string","format":"uuid","description":"The item's UUID (from a content list)."},"site_id":{"type":"string","format":"uuid","description":"Site UUID — required when resolving by content_type + slug/title."},"content_type":{"type":"string","description":"Collection content type — required when resolving by slug/title."}},"additionalProperties":false}},{"name":"delete_content_item","title":"Delete content item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Delete a content item by id. Ownership is verified via the parent site's user_id. Returns the deleted item's slug and content_type for confirmation.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["item_id"],"properties":{"item_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"screenshot_page","title":"Look at the site","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Capture a JPEG of any page on a site so you can SEE what you composed and adjust before composing more. Use mid-generation: after create_site_from_template or update_site_from_fixture, screenshot the page you just built and review the layout, spacing, color use, and hierarchy. If something's off, patch it via patch_nodes or update_site_from_fixture before continuing. Always screenshots via the preview URL (preview-{slug}.{rootDomain}) — it always renders the current draft (or 302s to live when in sync). Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"slug":{"type":"string","description":"Page slug to screenshot (e.g. '/' or '/about' or '/work/aperture'). Defaults to '/'."},"site_id":{"type":"string","format":"uuid"},"viewport":{"enum":["desktop","tablet","mobile"],"type":"string","description":"Render width for the shot: 'desktop' (1024, default), 'tablet' (820), or 'mobile' (390). Use 'mobile' to verify the responsive breakpoint — that columns collapse to one, headings don't overflow, etc."},"full_page":{"type":"boolean","description":"Capture the ENTIRE page top-to-bottom, not just the first screenful. Set true to verify content below the fold — a contact form, footer, or sections after the hero. Default false = fast top-only crop."}},"additionalProperties":false}},{"name":"critique_design","title":"Review design","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Returns extracted design metrics for a site (per-page section signatures, CTA counts, heading hierarchy, placeholder text detection, site-wide color/font/spacing usage) for reviewing a site's design quality and producing a structured critique. Useful after composing or editing a site as a self-review pass, before claiming it's done. Different from site_health_check (which covers technical things like missing alt text, broken links). Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"},"page_slug":{"type":"string","description":"Optional — focus the critique on a single page slug (e.g. '/about'). When omitted, returns metrics for all pages."}},"additionalProperties":false}},{"name":"delete_site","title":"Delete a site permanently","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":true,"destructiveHint":true},"description":"Permanently delete a site — its subdomain row, all version snapshots, all content_items, all submissions, the alias history, attached custom domains (removed from Vercel), the Polar subscription (cancelled — Polar handles any refund), and any media in the storage bucket. IRREVERSIBLE. Use this when the user explicitly asks to scrap a site (e.g. 'delete my-portfolio-3947, I don't want it' or 'I created the wrong template, throw it away'). Requires `confirm: true` to be deliberate. Do NOT call this on user-said-something-vague — ask 'are you sure you want to delete {subdomain} permanently?' first and only call after explicit yes. There is no undo. If the Polar cancellation fails (network / Polar outage), the entire delete is aborted so the user is never charged for a deleted site.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","confirm"],"properties":{"confirm":{"type":"boolean","const":true,"description":"Required boolean — pass `true` to confirm. Forces Claude to be deliberate before destroying user data."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}}],"prompts":[],"resources":[],"triggers":[],"configSchema":null,"configAllowsEmpty":false},"className":"w-12 h-12 shrink-0"}],"$L77"]}],"$L78"]}],"$L79"]}]}],"$L7a"]}],"$L7b"]}]] </article></body></html>

61:[["$","$L6f",null,{"namespace":"sitelas","slug":"sitelas","ownerId":"org_01KZCBC07DYDPBCRKK5HBTE8FA","unlisted":false,"isLegacyFlyDeployment":false}],["$","$Lb",null,{"className":"mt-0 pt-4","children":[["$","div",null,{"className":"space-y-4","children":[["$","div",null,{"className":"pt-8","children":["$","div",null,{"className":"mb-3 shrink-0","children":[["$","div",null,{"className":"flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between sm:gap-4","children":[["$","div",null,{"className":"flex items-start gap-3 min-w-0 flex-1","children":[["$","$L70",null,{"server":{"id":"a7410ed3-f5b7-4b8d-9726-76ef679a05c0","displayName":"Sitelas","description":"The website builder for AI agents. Build a real site from a chat, then run it — read the messages it collects, check traffic, edit content, preview and publish.","namespace":"sitelas","slug":"sitelas","qualifiedName":"sitelas/sitelas","iconUrl":"https://api.smithery.ai/servers/sitelas/sitelas/icon","homepage":"https://sitelas.com","repositoryUrl":null,"backlinkUrl":null,"license":null,"verified":false,"official":false,"verification":{"official":false,"homepageHost":"sitelas.com","verificationValue":"smithery-verification=2290274e02ff98bf560631d6888a06378b92c3b590990521f57e4f08775c0176","hasDomainProof":false,"hasBacklinkProof":false,"backlinkUrl":null,"checkedAt":"$D2026-08-06T20:47:36.582Z","nextCheckAt":"$D2026-08-06T21:47:36.582Z"},"unlisted":false,"remote":true,"createdAt":"$D2026-08-06T20:18:23.443Z","organizationId":"org_01KZCBC07DYDPBCRKK5HBTE8FA","bySmithery":false,"runToolsSlug":"sitelas","securityScan":{"isSecure":null},"lastDeployedAt":"2026-08-06T20:25:32.068Z","lastSuccessfulDeployment":{"type":"external_shttp","mcpUrl":"https://sitelas.run.tools","upstreamUrl":"https://sitelas.com/api/mcp","configSchema":{},"cfDeploymentHash":null},"mcpUrl":"https://sitelas.run.tools","tools":[{"name":"list_sites","title":"List sites","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List all websites owned by the current user. Returns subdomain, publish status, live URL, plan tier, and creation date for each. Use get_site for per-site detail.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{},"additionalProperties":false}},{"name":"get_site","title":"Get site","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Fetch details of a single site: pages (slug/title/order/edit URL), theme summary, publish status, and live + preview URLs. Does NOT return the node tree (use get_site_tree) or version history (use list_site_versions). By default returns a slim theme (slug + palette tokens + font families) to keep the response compact; pass include_theme_config=true if you need the complete theme config object.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"},"include_theme_config":{"type":"boolean","description":"When true, returns the complete theme object (all colors, typography, spacing, semantic tokens, etc.). When false or omitted (default), returns a slim theme summary — slug, palette tokens, font families — which is enough for almost every decision and keeps the response compact. Set true only when you need to round-trip the theme (e.g., before patch_fixture against /theme/config/...)."}},"additionalProperties":false}},{"name":"get_preview","title":"Preview the site","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Fetch a fresh screenshot of a site's home page via the preview URL (preview-{slug}.{rootDomain}). The preview URL always renders: when there are unpublished edits it shows the draft, when draft equals live it 302-redirects to the published live site. IMPORTANT: that redirect means when there are NO unpublished edits, sharing the preview URL shows the user the LIVE site, not a private preview — only share it as a 'preview to review before publishing' when there are actually unpublished draft changes (i.e. right after an edit). Use after edits to confirm changes look right. Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"},"viewport":{"enum":["desktop","tablet","mobile"],"type":"string","description":"Render width: 'desktop' (1024, default), 'tablet' (820), or 'mobile' (390) to check the responsive breakpoint."},"full_page":{"type":"boolean","description":"Capture the ENTIRE home page top-to-bottom, not just the first screenful. Set true to review content below the fold. Default false."}},"additionalProperties":false}},{"name":"add_page","title":"Add page","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"$71","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug","title"],"properties":{"slug":{"type":"string","pattern":"^\\/[a-z0-9/-]*$","maxLength":200,"minLength":1},"title":{"type":"string","maxLength":200,"minLength":1},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"update_page","title":"Update page","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Update a page's metadata: rename its slug, change its title, toggle visibility (`is_enabled`), reorder (`sort_order`), or replace its `metadata` blob (typically the SEO sub-object). At least one field must be passed. The page tree itself is NOT touched — use insert_nodes / patch_nodes for tree edits. To change the nav, edit the nav-link nodes directly (insert_nodes / patch_nodes / remove_nodes).\n\nRenames: the home page ('/') cannot be renamed (it'd break routing). new_slug must satisfy /^\\/[a-z0-9/-]*$/, not collide with any existing page, and not shadow a reserved Sitelas route (`edit`). By default, every node whose `data.href` / `data.url` equals the old slug is rewritten to the new slug in the same draft write — so internal links stay valid after the rename. The response reports the count and the rewritten node ids. Pass `rewrite_links: false` to skip the auto-rewrite (only useful when the caller intends to surgically patch the hrefs themselves). Writes a new draft version; call publish_site to push live.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Current slug of the page to update (must exist). Use '/' for the home page."},"title":{"type":"string","maxLength":200,"minLength":1},"site_id":{"type":"string","format":"uuid"},"metadata":{"type":"object","description":"Page-level metadata blob — typically holds `seo.*` (title, description, robots, og_image).","additionalProperties":{}},"new_slug":{"type":"string","pattern":"^\\/[a-z0-9/-]*$","maxLength":200,"minLength":1,"description":"Rename the page to this slug. Must match /^\\/[a-z0-9/-]*$/ and not collide with an existing page or reserved route. Internal links pointing at the old slug are NOT auto-rewritten — the response surfaces a count of nodes that referenced the old slug so the caller can follow up with patch_nodes."},"is_enabled":{"type":"boolean","description":"Hide from public render while keeping the page tree intact. Disabled pages still load in preview mode for the owner."},"sort_order":{"type":"integer","description":"Re-order in the nav. Lower numbers come first; home (`/`) is conventionally 0."},"rewrite_links":{"type":"boolean","description":"On rename, automatically rewrite every node's `data.href` / `data.url` that equaled the old slug to the new slug. Default true — keeps internal links working after the rename. Set false to leave inbound hrefs untouched (the response still reports the count, so the caller can rewrite them manually with patch_nodes)."}},"additionalProperties":false}},{"name":"duplicate_page","title":"Duplicate page","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Clone an existing page to a new slug. Deep-copies the source page's full tree (regenerating every node id so the copy is independent) and creates a new page with the same nav group and enabled state. Use for 'clone the pricing page for a new tier' / 'make a second case-study page like this one'. The copy lands as a draft; edit it with patch_nodes and publish when ready. Fails if new_slug already exists or is reserved.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug","new_slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Slug of the existing page to duplicate (e.g. '/pricing')."},"site_id":{"type":"string","format":"uuid"},"new_slug":{"type":"string","pattern":"^\\/[a-z0-9/-]*$","maxLength":200,"minLength":1,"description":"Slug for the new copy. Must match /^\\/[a-z0-9/-]*$/ and not collide with an existing page."},"new_title":{"type":"string","maxLength":200,"minLength":1,"description":"Title for the copy. Defaults to the source title with ' (copy)' appended."}},"additionalProperties":false}},{"name":"delete_page","title":"Delete page","annotations":{"readOnlyHint":false,"openWorldHint":false,"destructiveHint":true},"description":"Delete a page from a site. Cannot delete the home page ('/'). By default also prunes nav-link entries (header / footer / pageLayout / page bodies) that point at the deleted slug so the deletion leaves no broken nav links — set prune_nav_links:false to keep them. A nav-link is kept (with a warning) if removing it would empty its nav-links container. Writes the change into the draft slot — call publish_site to push the deletion live. Returns the preview URL.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1},"cascade":{"type":"boolean","description":"When true, also delete child pages whose slugs start with `${slug}/`."},"site_id":{"type":"string","format":"uuid"},"prune_nav_links":{"type":"boolean","description":"When true (default), also remove nav-link nodes across the header, footer, pageLayout, and page bodies whose href targets a deleted slug — so the deletion doesn't leave broken nav entries. A nav-link is left in place (with a warning) if removing it would empty its nav-links container."}},"additionalProperties":false}},{"name":"publish_site","title":"Publish site","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"Promote the draft slot into the live slot. PREREQUISITE: only call this after the user has reviewed the preview URL and EXPLICITLY told you to publish — never auto-publish, never treat 'change X' as 'change X and publish'. Three-state model: the current live snapshot (if any) is archived into previous_live so the owner can one-step undo (revert_site). The handler probes the live URL before returning, so `url` is GUARANTEED to render (falls back to the preview URL if ISR is still warming). Publishing is NOT plan-gated — free sites publish as many times as they like; only a suspended site is refused. Returns a warning when a published page has no content and would render blank.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"unpublish_site","title":"Unpublish site","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":true},"description":"Take the site offline (its subdomain will 404 for visitors). The live snapshot is archived into the previous_live slot so the owner can re-publish via Undo last publish without re-editing. The draft slot is untouched.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"publish_page","title":"Publish page","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"Publish ONE page independently: its latest draft goes live on its own, leaving every other page and the site-wide header/theme exactly as they are. Use this to push a single page's changes (or a brand-new page) live without republishing the whole site. The site must already be live — do the first publish with publish_site. Like publish_site, only publish when the user asked you to. Returns a warning when there are also unpublished site-wide (theme/header) changes that this did NOT ship.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Page path, e.g. '/about' or '/' for home."},"locale":{"type":"string","description":"Locale of the page variant. Defaults to 'en'."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"publish_content_item","title":"Publish content item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"Publish ONE collection item independently: its latest draft goes live on its own, leaving every other item, every page, and the site-wide header/theme exactly as they are. This is the tool for taking a SINGLE new or edited post live without republishing the whole site — pair it with `add_content_item` (which only writes a DRAFT) to publish a blog post: `add_content_item` then `publish_content_item`. (For an unattended, connection-drop-safe daily post, prefer `schedule_content_publish` with publish:true, which does the insert + take-live durably server-side.) The site must ALREADY be live — do the first publish with `publish_site`. Like publish_site, only publish when the user asked you to (a standing 'auto-publish the daily post' instruction counts as that approval). Returns a warning when there are also unpublished site-wide (theme/header/collection) changes that this did NOT ship.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"The item's slug (single-segment kebab-case)."},"locale":{"type":"string","description":"Locale of the item variant. Defaults to 'en'."},"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1,"description":"The collection's content_type, e.g. 'blog' or 'project'."}},"additionalProperties":false}},{"name":"unpublish_page","title":"Unpublish page","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"Take ONE page off the live site without affecting the rest. The page's live URL starts returning 404 and it drops out of the auto-generated nav; its draft is kept so you can re-publish it later with publish_page. The rest of the site stays live. Returns `unpublished: false` if the page had no live version. This changes what's live — only do it when the user explicitly asks to take a page down.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","slug"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Page path to take off the live site, e.g. '/about'."},"locale":{"type":"string","description":"Locale of the page variant. Defaults to 'en'."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_submissions","title":"List form submissions","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List form submissions for a site. Returns summaries (name, email, form_type, `source` — which page/form the submission came from, e.g. a specific job position — is_read, preview of message, and `attachments` — any uploaded files as {field, name, url} with DURABLE download links safe to paste into an exported Google Sheet / CSV) plus a `monthly_counter` block (used / limit / over_limit / resets_at / plan). The limit is SOFT: submissions are never rejected or dropped on any plan — over-limit they still record and fan out to the webhook. When `over_limit` is true, tell the user they've passed their plan's monthly allowance (nothing was dropped) — on Free that's an upgrade nudge to Pro's higher allowance. Filter by form_type, unread_only, or since-timestamp. Use `read_submission` to fetch the full payload of one.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"since":{"type":"string","format":"date-time"},"site_id":{"type":"string","format":"uuid"},"form_type":{"enum":["contact","waitlist","newsletter","rsvp","quote","custom"],"type":"string"},"unread_only":{"type":"boolean"}},"additionalProperties":false}},{"name":"read_submission","title":"Read form submission","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"Fetch the full content of a form submission by id — name, email, message, every field value, and the form's schema at submission time. By default also marks the submission as read. Set mark_read=false to leave the is_read flag alone.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["submission_id"],"properties":{"mark_read":{"type":"boolean","default":true},"submission_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_contacts","title":"List site contacts","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List contacts who have interacted with a site (filled a form, subscribed to newsletter). Filter by text, tags, or activity thresholds (min_submissions, subscribed_only, since). Ordered by most recent activity.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"since":{"type":"string","format":"date-time"},"offset":{"type":"integer","default":0,"minimum":0},"search":{"type":"string"},"site_id":{"type":"string","format":"uuid"},"min_submissions":{"type":"integer","minimum":0},"subscribed_only":{"type":"boolean"}},"additionalProperties":false}},{"name":"get_contact","title":"Get site contact","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Fetch a single contact record for a site by email. Returns activity totals, tags, subscription status. Use `list_contact_activity` to get their interaction timeline.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","email"],"properties":{"email":{"type":"string","format":"email"},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_contact_activity","title":"List contact activity","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Chronological list of a contact's interactions with the site — form submissions they made, newsletter subscribe/unsubscribe events. Most recent first. Useful for 'tell me everything we know about Sarah'.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","email"],"properties":{"email":{"type":"string","format":"email"},"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"get_analytics","title":"Get site analytics","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Fetch pageview and unique-visitor analytics for a site over a date range. Returns totals, a daily timeseries, top paths, and top referrers. Default range is trailing 28 days ending today. Use `range_days` for a trailing window, or `since` + `until` for explicit bounds.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"since":{"type":"string"},"top_n":{"type":"integer","default":10,"maximum":50,"minimum":1},"until":{"type":"string"},"site_id":{"type":"string","format":"uuid"},"range_days":{"type":"integer","default":28,"maximum":365,"minimum":1}},"additionalProperties":false}},{"name":"schedule_publish","title":"Schedule publish / unpublish","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Schedule a publish or unpublish to happen later. `action: \"publish\"` flips the site live at `run_at`; `action: \"unpublish\"` takes it down. Use for launches, time-limited campaigns, or scheduled maintenance windows.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","action","run_at"],"properties":{"note":{"type":"string","maxLength":200},"action":{"enum":["publish","unpublish"],"type":"string"},"run_at":{"type":"string","format":"date-time"},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"schedule_content_publish","title":"Durably publish a collection item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Enqueue a DURABLE 'create this collection item (and take the site live)' job instead of writing it over this connection. Use this for UNATTENDED / scheduled runs (e.g. a daily auto-published blog post): a server-side worker performs the insert with retries + slug-idempotency, so a connector drop can't lose the post or double-post it. The payload is validated NOW (collection must exist, content must match the schema) so mistakes fail fast here rather than silently in the worker. Returns a job_id you can track with list_scheduled_jobs. For interactive edits you're watching, use add_content_item directly instead.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","slug","content"],"properties":{"note":{"type":"string","maxLength":200},"slug":{"type":"string","maxLength":200,"minLength":1},"run_at":{"type":"string","format":"date-time","description":"ISO time to run. Omit to run on the next cron tick (≤5 min)."},"content":{"type":"object","additionalProperties":{}},"publish":{"type":"boolean","description":"Take the site live after inserting. Default true."},"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1},"published_at":{"type":"string","format":"date-time"}},"additionalProperties":false}},{"name":"list_scheduled_jobs","title":"List scheduled jobs","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List scheduled jobs for a site. Filter by status (pending/running/done/failed/cancelled), kind, or run_at range. Defaults to every job ordered by run_at ascending (next up first).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"kind":{"enum":["publish_site","unpublish_site"],"type":"string"},"limit":{"type":"integer","default":100,"maximum":500,"minimum":1},"since":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"},"offset":{"type":"integer","default":0,"minimum":0},"status":{"anyOf":[{"enum":["pending","running","done","failed","cancelled"],"type":"string"},{"type":"array","items":{"$ref":"#/properties/status/anyOf/0"},"maxItems":5}]},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"cancel_scheduled_job","title":"Cancel scheduled job","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":true},"description":"Cancel a pending scheduled job. Returns the job's current status — if it already ran, was cancelled, or is running, we don't flip it back. Only 'pending' jobs transition to 'cancelled'.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","job_id"],"properties":{"job_id":{"type":"string","format":"uuid"},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"start_upgrade","title":"Start upgrade checkout","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Create a Polar checkout URL to upgrade a site to Pro ($9/mo). Returns a clickable link the user can pay through. If the site is already on Pro, returns a message instead of a link. Does NOT mutate plan state — the site only moves to Pro after Polar fires the webhook on successful payment.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","plan"],"properties":{"plan":{"enum":["pro"],"type":"string"},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_site_templates","title":"Browse design directions","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"List available site templates (archetypes) Claude can start a new site from. Each template is a complete, hand-tuned design direction with one palette, one typography pair, and a specific page composition — a structural starting point, NOT a rigid final design. Use this to pick the best-fit archetype for a brief, then call create_site_from_template to persist a new site based on it. After creation, customize via brand_overrides + patch_nodes (the bulk patch primitive — one call covers every text/image/cta change) + find_images for imagery; the archetype is the skeleton, your customization is the specific site. Pass `category` to filter — 9 categories: 'portfolio', 'academic', 'business', 'food', 'saas', 'content', 'realestate', 'events', 'document'. Omit to see all ~29 templates.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"category":{"type":"string","description":"Optional category filter — matches against the template's stored category or keywords in its description. Categories: 'portfolio', 'academic', 'business', 'food', 'saas', 'content', 'realestate', 'events', 'document'. Omit to see everything."}},"additionalProperties":false}},{"name":"select_template_for_brief","title":"Pick a template for a brief","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Score every available template against a parsed brief and return the top matches with reasoning. Call this BEFORE create_site_from_template when the user has a real brief — it picks the best archetype using structured metadata (audience, register, conversion goal, integrations) instead of prose-matching. The output explains WHY each template ranked where it did so you can confidently pick the top result. Use list_site_templates instead when the user is browsing without a clear brief, or when they ask 'what other options are there.'","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["audience"],"properties":{"top_n":{"type":"integer","default":3,"maximum":10,"minimum":1,"description":"How many ranked matches to return. Default 3. Higher values useful for exploring tradeoffs; 1 forces a confident pick."},"density":{"enum":["image-led","text-led","balanced"],"type":"string","description":"How image-heavy the site should feel. 'lots of photos / image-first' → image-led; 'mostly text, sparse imagery' → text-led; 'mixed' → balanced. Omit if unclear."},"audience":{"enum":["solo-creative","solo-expert","solo-academic","creator-with-content","local-smb-trade","local-smb-hospitality","local-smb-service","maker-retail","b2b-firm","b2b-product","academic-institution","nonprofit","real-estate","single-event","single-paper","personal-document"],"type":"string","description":"WHO the site is for. Most useful single signal, and the one the ranking swings hardest on — 'yoga studio owner' → local-smb-service; 'business coach' → solo-expert; 'photographer' → solo-creative; 'law firm' → b2b-firm; 'podcaster' → creator-with-content; 'nonprofit' → nonprofit; 'jeweller / ceramicist / candle maker / small-batch food producer' → maker-retail. Note maker-retail vs solo-creative: a maker sells a physical OBJECT (catalogue + buy buttons, or custom-order enquiries), a solo-creative sells work-for-hire (portfolio is the pitch). Getting this wrong sends a bead-jewellery studio to a dark engineer-portfolio template. Pick the closest match; the scorer also considers each template's audienceAlt."},"keywords":{"type":"array","items":{"type":"string"},"description":"Free-form keywords from the brief — used as soft signal against each template's useCases and antiCases. E.g. ['yoga', 'studio', 'class signup', 'restorative']. The scorer matches these against each template's useCases (positive) and antiCases (negative)."},"register_hint":{"enum":["editorial-warm","editorial-modern","editorial-bold","modernist-minimal","authority-formal","craft-luxury","utilitarian-trustworthy","clinical-trustworthy","calm-professional","playful-warm","tech-precise","agency-dramatic","fine-dining-dark"],"type":"string","description":"Visual + tonal mood the brief asks for. 'calm/restorative/wellness' → calm-professional; 'utility/family-owned/trades' → utilitarian-trustworthy; 'fine dining/dark/refined' → fine-dining-dark; 'editorial/warm-paper/literary' → editorial-warm; 'modernist/sans/whitespace' → modernist-minimal; 'authoritative/legal/formal' → authority-formal; 'kids/playful/family' → playful-warm; 'agency/dramatic/dark-mode' → agency-dramatic. Omit if the brief is silent on visual mood."},"conversion_goal":{"enum":["lead-form","discovery-call","booking-form","contact-only","portfolio-inquiry","donation","newsletter-signup","subscribe-platform","ticket-sale","product-sale","info-only","menu-reservation","tour-booking"],"type":"string","description":"Primary CTA shape the brief asks for. Booking calendar → booking-form; discovery call → discovery-call; donation → donation; newsletter signup → newsletter-signup; ticket sale → ticket-sale; selling a physical product → product-sale; restaurant → menu-reservation; tour booking (school/program) → tour-booking; nothing transactional → info-only; standard 'contact us' → lead-form. product-sale means one stripe-payment-link button per item — Sitelas has no cart, so a catalogue of buy buttons is the shape, not a storefront with checkout."},"avoid_categories":{"type":"array","items":{"type":"string"},"description":"Coarse categories to filter out. E.g. ['academic'] when the brief is industry-only. Most useful for steering away from over-served categories."},"integrations_required":{"type":"array","items":{"enum":["calendly-embed","stripe-payment-link","form","video-embed","audio-player","code-blocks","none"],"type":"string"},"description":"Integrations the brief explicitly calls for. Calendly link → calendly-embed; payment button → stripe-payment-link; podcast platform buttons → audio-player; embedded video → video-embed; code samples → code-blocks. Omit if none specified."}},"additionalProperties":false}},{"name":"create_site_from_template","title":"Compose site","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Create a new Sitelas site by cloning a template archetype. The template provides the design skeleton (page composition, section layouts, typography rhythm); you customize it for the specific brief via brand_overrides at create time + ONE bulk patch_nodes call afterwards (the only patch primitive — no per-node fallback). The site is saved as a DRAFT — not publicly live until the user approves and you call publish_site. Returns `url` (preview URL, best shared after customization patches are applied), `site_id` for subsequent edits, `manifest` (every patchable node id + current text + slot, replaces get_site for discovery), `customization_brief` (prose guidance for this archetype), `overrides_applied`, and `next_step` (a suggested follow-up summary). Standard customization pattern after this call: read the manifest, build one patches array covering every text/image/cta change across all pages and siteElements, send one patch_nodes call.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["template_slug","site_name"],"properties":{"site_name":{"type":"string","maxLength":60,"minLength":1,"description":"Human-readable site name. Stored on the template metadata and used as the default base for the subdomain slug. Note: does NOT automatically substitute into visible header/footer brand text — include the header brand-name node in your patch_nodes batch (slot: 'brand-name' in the manifest) to update the displayed brand."},"subdomain":{"type":"string","pattern":"^[a-z0-9-]{3,32}$","description":"Preferred subdomain slug (a-z, 0-9, hyphen, 3–32 chars). Auto-generated from site_name if omitted. A 4-digit suffix is always appended to guarantee uniqueness."},"template_slug":{"type":"string","minLength":1,"description":"Slug of the template archetype to clone (from list_site_templates). E.g. 'base-folio', 'beacon', 'flagship'."},"brand_overrides":{"type":"object","properties":{"body_font":{"type":"string","description":"Override the template's body font. CSS font-family value (e.g. 'Inter, sans-serif', 'Söhne, system-ui, sans-serif'). Pair with heading_font when the brief demands a specific register."},"accent_color":{"type":"string","description":"Override the template's accent color — the most common useful knob. Used for primary buttons, emphasis moments, and highlights. Hex or CSS color."},"heading_font":{"type":"string","description":"Override the template's heading font. CSS font-family value (e.g. 'Fraunces, serif', 'Tiempos, Georgia, serif'). When the brief names a specific aesthetic (rainy PNW, brutalist, Victorian, editorial newsprint, mid-century) pass a font that carries that mood — typography is half the register, don't leave it on the template's default when the brief has named one. Common picks: 'Fraunces' (warm editorial), 'Tiempos' (literary), 'Caslon' (classical), 'Instrument Serif' (display italic), 'Bricolage Grotesque' (humanist sans), 'JetBrains Mono' (technical)."},"primary_color":{"type":"string","description":"Override the template's primary color. Hex ('#1a1a1a'), rgb, or CSS color. Use sparingly — the template's palette was designed as a whole; single-color overrides can disrupt contrast. Prefer tweaking just the accent."},"background_color":{"type":"string","description":"Override the template's background color. Use carefully: background changes shift the whole site's mood and often require re-tuning contrast."}},"description":"Theme nudges applied at create time: primary/accent/background color, heading/body font. When the brief names a specific mood (rainy PNW, brutalist, Victorian, editorial newsprint) pass both color AND typography that match — don't set colors and leave fonts as the template's default. Each knob is independent. Omit entirely only when the brief says 'use the template as-is' or is silent on both color and typography.","additionalProperties":false}},"additionalProperties":false}},{"name":"create_site_from_fixture","title":"Compose site from fixture","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Persist a fixture YOU composed as a new Sitelas site. Use this when the archetype-based create_site_from_template can't produce the structure you need — primarily for URL cloning (post-capture_url, when the source's section composition doesn't map cleanly to any of the ~29 archetypes), or for genuinely bespoke briefs that no archetype satisfies. For typical generation, prefer create_site_from_template — its archetypes are designer-tuned and produce higher-quality output by default. The fixture is validated (validate_fixture autofixes minor issues, throws on hard structural errors), then saved as a DRAFT (live URL 404s until publish_site). Returns the preview URL, site_id, manifest of patchable nodes, and warnings (e.g. unreachable pages).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["fixture","site_name"],"properties":{"fixture":{"type":"object","required":["template","theme"],"properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":{}}},"theme":{"type":"object","additionalProperties":{}},"template":{"type":"object","additionalProperties":{}},"siteElements":{"type":"object","additionalProperties":{}}},"description":"Complete Fixture you composed. Must include `template` (metadata), `theme.config` (color tokens + typography), and `pages` (at minimum a '/' page with a `tree`). Optional: `siteElements.header/footer/pageLayout`, `collections` (each with its own `template`, `pathPrefix`, and `items[]` for starter rows). The fixture goes through validate_fixture's autofix pass, so minor structural issues are repaired automatically; hard errors are returned with paths.","additionalProperties":true},"site_name":{"type":"string","maxLength":60,"minLength":1,"description":"Human-readable site name. Used as the metadata label and as the default subdomain base. Does NOT auto-substitute into header/footer brand text — set the brand text in your fixture's siteElements.header explicitly."},"subdomain":{"type":"string","pattern":"^[a-z0-9-]{3,32}$","description":"Preferred subdomain slug (a-z, 0-9, hyphen, 3–32 chars). Auto-generated from site_name if omitted. A 4-digit suffix is always appended to guarantee uniqueness."}},"additionalProperties":false}},{"name":"list_primitives","title":"List primitives","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Return every primitive available in the Sitelas renderer plus tree-level constraints. Each primitive entry includes `style_strip` (when present) — a map of style props the primitive's renderer intentionally drops, paired with the actionable alternative. Response also surfaces `max_tree_depth` — the nesting ceiling the tree-validator enforces (children deeper than this are truncated). Read this BEFORE composing fixtures; saves trial-and-error from setting layout props on a Section that strips them, or from nesting too deeply for a bento layout. For full prop schemas, call get_primitive_schema(type) on a specific type.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{},"additionalProperties":false}},{"name":"get_primitive_schema","title":"Get primitive schema","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Return the full prop schema for a single primitive: types, defaults, options, required fields, allowed children, and `styleStrip` — a map of {style prop: actionable hint} for any inline-style props this primitive's renderer intentionally drops (e.g. on `section`, layout props like `display`/`flexDirection` are stripped because Section is a semantic wrapper; use a Stack/Grid child instead). Read styleStrip BEFORE setting style on a node — eliminates the silent-drop trial-and-error.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["type"],"properties":{"type":{"type":"string","minLength":1}},"additionalProperties":false}},{"name":"list_section_archetypes","title":"List section archetypes","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Return section archetypes (hero, menu-grid, testimonials, contact-cta, etc.) recommended for a given site category. Each archetype includes when to use it and a description you can adapt when composing a Fixture.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["category"],"properties":{"category":{"type":"string","minLength":1,"description":"Site category — one of: saas, restaurant, bakery, wedding, blog, portfolio, agency, event, medical, course, nonprofit, creator, service, wellness, resume, realestate, docs, academic, linkinbio, general."}},"additionalProperties":false}},{"name":"get_example_fixtures","title":"Get example fixtures","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Return complete example fixtures in the shape Sitelas expects — a Rosetta Stone for which fields are required vs optional, how responsiveStyle nests, what a real siteElements.header tree looks like, what shape data.items/data.tiers/etc actually take in practice. Study one for shape; compose your own for content. Pass minimal: true when you only need the structural skeleton (saves ~70-80% of token weight). The fastest path to a correct first call on an unfamiliar category is calling this once with that category, reading the skeleton, then composing from list_primitives + design principles — not avoiding examples on principle. The goal is never to replicate the reference; it's to get the shape right on call #1.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"type":"integer","maximum":10,"minimum":1,"description":"Max number of fixtures to return (default 3, max 10)."},"minimal":{"type":"boolean","description":"When true, return a trimmed shape: full template + theme metadata, but only the FIRST page's tree (truncated to max 8 sections), and siteElements without their inner trees. Drops ~70-80% of token weight on per-fixture responses while keeping the shape Claude needs for composition reference. Default false (full fixture). Use minimal=true when you only need to confirm the structure, not study a complete site."},"categories":{"type":"array","items":{"type":"string"},"description":"Site categories to sample (e.g. ['saas', 'portfolio', 'food']). Up to one fixture per category is returned. Omit to get a diverse default sample."}},"additionalProperties":false}},{"name":"validate_fixture","title":"Validate fixture","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Optional debugging tool. Validates a Fixture against Sitelas's schema + quality bar, returning errors with paths and an autofixed fixture when issues can be repaired (missing alt text, duplicated h1s, etc.). Do NOT run this before create_site_from_template or update_site_from_fixture as a matter of course — those tools already validate internally and return the same errors. Use this only when you want to sanity-check a composition in isolation (e.g. before spending tokens on a very large fixture) or when a create/update rejected with a validation error you want to inspect in detail.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["fixture"],"properties":{"fixture":{"type":"object","description":"The Fixture JSON object to validate.","additionalProperties":{}}},"additionalProperties":false}},{"name":"update_site_from_fixture","title":"Refine site","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Update an existing Sitelas site with a Claude-composed fixture. Provide `fixture` to replace the entire site (all pages + site elements), or `page_updates` to modify specific pages only. Updates are saved as a DRAFT — the live URL is UNCHANGED until publish_site is called. The response includes `url` (the preview URL for reviewing the draft), `permanent_url` (the live URL — see `live_status` for what it currently serves), and a `next_step` hint phrased correctly for the live URL's state. ALWAYS share `url` and relay `next_step` verbatim — do NOT say the change is live at permanent_url; it isn't.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"theme":{"type":"object","required":["id","name","slug","description","category","is_default","is_active","config","version"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"config":{"type":"object","additionalProperties":{}},"version":{"type":"string"},"category":{"enum":["light","dark","colorful","general"],"type":"string"},"is_active":{"type":"boolean"},"is_default":{"type":"boolean"},"description":{"type":"string"}},"description":"Optional theme swap. Can be combined with either fixture or page_updates.","additionalProperties":false},"fixture":{"type":"object","description":"Full updated Fixture — replaces all pages and site elements. Provide this OR page_updates, not both.","additionalProperties":{}},"site_id":{"type":"string","format":"uuid","description":"The site UUID returned by create_site_from_template or list_sites."},"page_updates":{"type":"array","items":{"type":"object","required":["slug","tree"],"properties":{"slug":{"type":"string","minLength":1,"description":"Page slug, e.g. '/' or '/about'."},"tree":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"type":{"type":"string"},"style":{"type":"object","additionalProperties":{}},"children":{"type":"array","items":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"type":{"type":"string"},"style":{"type":"object","additionalProperties":{}},"children":{"type":"array","items":{"$ref":"#/properties/page_updates/items/properties/tree/properties/children/items"}}},"additionalProperties":false}}},"description":"The full replacement node tree for this page.","additionalProperties":false}},"additionalProperties":false},"description":"Partial update — only the listed pages are changed. Provide this OR fixture, not both."}},"additionalProperties":false}},{"name":"list_site_versions","title":"List site versions","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Three-state snapshot model: returns the live slot (currently published), the draft slot (current working copy), and the previous-live slot (one-step undo target, if any). Use revert_site to roll back to the previous-live snapshot.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"revert_site","title":"Undo last publish","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Roll back to the snapshot that was live before the most recent publish. One-step undo only — the three-state model keeps just one prior live snapshot. Returns restored=false when there's nothing to undo (site has only ever been published once, or already undone). The live URL is verified to render before return.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"get_version_diff","title":"Diff two site snapshots","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Compare two slots of the three-state snapshot model (live / draft / previous) and return a structured summary of what changed: pages added or removed, pages whose top-level section count changed (and by how much), whether the theme changed, and whether the shared header/footer changed. Common pairings: from=live to=draft (what would publish do), from=previous to=live (what did the last publish do).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","from","to"],"properties":{"to":{"$ref":"#/properties/from"},"from":{"enum":["live","draft","previous"],"type":"string","description":"Three-state slot. 'live' = currently published, 'draft' = working copy, 'previous' = the snapshot live before the most recent publish (one-step undo target)."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"capture_url","title":"Capture URL","annotations":{"readOnlyHint":true,"openWorldHint":true},"description":"$72","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"The public URL to capture."},"viewport":{"enum":["desktop","mobile"],"type":"string","default":"desktop","description":"Viewport preset. Defaults to 'desktop' (1440px wide)."}},"additionalProperties":false}},{"name":"upload_image_from_url","title":"Upload image from URL","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false},"description":"Fetch an image from a public URL, store it on Sitelas's CDN under the site's storage namespace, and return a stable public URL. Use this whenever Claude wants to add a real image to a site instead of an external URL that may rot. Accepts JPEG/PNG/WebP/GIF/SVG up to 10MB raw. Non-SVG images are processed through sharp (resized + converted to WebP). Returns dimensions, byte size, and a blur placeholder for instant LQIP rendering.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","url","alt"],"properties":{"alt":{"type":"string","maxLength":300,"minLength":1,"description":"Accessibility alt text for the image. Required — supplying real alt text is part of the contract."},"url":{"type":"string","format":"uri","description":"Public HTTPS URL of an image (jpeg/png/webp/gif/svg). Must respond within 30s and be under 10MB raw."},"site_id":{"type":"string","format":"uuid","description":"The site UUID. The image is uploaded under this site's storage namespace."}},"additionalProperties":false}},{"name":"find_images","title":"Find images","annotations":{"readOnlyHint":true,"openWorldHint":true,"idempotentHint":true},"description":"Search a curated stock photography library (Pexels) for real imagery to use in a site. Call this BEFORE composing any section that needs imagery — hero, feature-grid with visuals, testimonial cards with portraits, gallery sections, media-and-text sections. Returns large-size URLs, thumbnails, dimensions, average color, and suggested attribution. Chain with upload_image_from_url to persist the chosen image to the site's storage namespace (recommended — external URLs can rot). Be specific with queries; 'brooklyn bakery sourdough on wooden counter' returns much better results than 'bakery'. Rate-limited to 30 searches per minute per user.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["query"],"properties":{"count":{"type":"integer","maximum":20,"minimum":1,"description":"How many results to return. Default 6, max 20."},"query":{"type":"string","maxLength":120,"minLength":1,"description":"Search query — be specific. 'brooklyn bakery sourdough loaves on wooden counter' beats 'bakery'. Good queries describe subject, setting, mood, lighting; bad queries are single generic nouns."},"orientation":{"enum":["landscape","portrait","square"],"type":"string","description":"Shape filter. 'landscape' for full-bleed heroes / media sections, 'portrait' for sidebar + testimonial portraits, 'square' for avatars and team tiles. Omit to get the mix Pexels returns by default."}},"additionalProperties":false}},{"name":"replace_images_from_search","title":"Source imagery","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false},"description":"Replace many image nodes at once: for each {node_id, query} patch, search Pexels, upload the top match to the site's CDN, and patch the node's src + alt — all in ONE tool call, batched into ONE new draft version. Use this after create_site_from_template to swap every placeholder image at once instead of doing 2N sequential calls (find_images + upload_image_from_url per image). Build the patches array from the manifest's image_nodes (each entry has a suggested_query you can use directly, override when the brief calls for something more specific). Up to 20 images per call. Each patch's node_id must exist in the current fixture; missing nodes are reported as skipped (not fatal — other patches still apply).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","patches"],"properties":{"patches":{"type":"array","items":{"type":"object","required":["node_id","query"],"properties":{"alt":{"type":"string","maxLength":300,"description":"Optional alt-text override. If omitted, uses the Pexels-provided alt (falling back to the query)."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Pexels search query — be specific. 'oakland ceramic studio interior wheel' beats 'pottery'. The top matching landscape image (or matching the requested orientation) replaces the node's src."},"node_id":{"type":"string","minLength":1,"description":"The id of the image node to replace (must match an existing image_node id from the site's manifest)."},"orientation":{"enum":["landscape","portrait","square"],"type":"string","description":"Shape filter for this image. Default 'landscape' for hero/section images, 'portrait' for person/team headshots, 'square' for avatars."}},"additionalProperties":false},"maxItems":20,"minItems":1,"description":"Array of image-replacement patches. Each item: a node_id from the site's manifest plus a Pexels query. Tool searches, uploads, and patches all in ONE round-trip. Each node_id may appear at most once. Up to 20 images per call (Pexels rate budget)."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"upload_image_from_data","title":"Upload image from base64 data","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Upload an image supplied as raw base64 bytes to Sitelas's CDN under the site's storage namespace, and return a stable public URL. Use this when Claude has image bytes in hand (e.g. a generated/edited image, an attachment) instead of a public URL — prefer `upload_image_from_url` whenever the image IS fetchable, because base64 inflates the payload by ~33% and large images get cut off in transit. Keep base64 uploads under ~1MB. Accepts JPEG/PNG/WebP/GIF/SVG up to 10MB decoded. Non-SVG images are processed through sharp (resized + converted to WebP). Returns dimensions, byte size, and a blur placeholder for instant LQIP rendering.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","base64","alt","mime_type"],"properties":{"alt":{"type":"string","maxLength":300,"minLength":1,"description":"Accessibility alt text for the image. Required — supplying real alt text is part of the contract."},"base64":{"type":"string","minLength":1,"description":"Base64-encoded image bytes (no `data:` URI prefix — just the raw base64 payload). Decoded size must be <= 10MB."},"site_id":{"type":"string","format":"uuid","description":"The site UUID. The image is uploaded under this site's storage namespace."},"mime_type":{"enum":["image/jpeg","image/png","image/webp","image/gif","image/svg+xml"],"type":"string","description":"MIME type of the supplied image bytes."}},"additionalProperties":false}},{"name":"verify_site","title":"Verify a site is actually live","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Independently confirm that a site is reachable. Reads the subdomain row, checks live_fixture is set, and screenshots the live URL to verify it actually renders. Use this AFTER create_site_from_template or whenever you want to be sure a URL works before sharing it with the user. Returns ok:true only when DB state + render both pass. Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"The site UUID returned by create_site_from_template or list_sites."},"require_live":{"type":"boolean","description":"When true (default), the tool fails if the live URL doesn't render. Set false to verify only the database state."}},"additionalProperties":false}},{"name":"patch_nodes","title":"Write content","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Apply many node-level patches to a site in ONE call, batched into one new draft version. The primary patch primitive — there is no single-node tool. Each patch entry provides the node_id plus one or more shorthand fields: 'text' for copy (auto-routes to data.text for heading/button/link/nav-link/banner-bar, data.content for text/rich-text/blockquote), 'href' for link destinations, 'src'/'alt' for images. For props not covered by shorthands (level on heading, variant on button, items on accordion), use 'data_patch' — its keys are validated against the primitive schema and unknown keys reject the whole batch with a clear error (prevents silent failures where the renderer ignores your key). Typical post-create flow: read the manifest, build an array of {node_id, text} entries for every placeholder copy string, send ONE call. Order doesn't matter — patches merge independently. Each node_id may appear at most once per batch; merge multi-field patches for the same node into one entry.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","patches"],"properties":{"patches":{"type":"array","items":{"type":"object","required":["node_id"],"properties":{"alt":{"type":"string","description":"Shorthand for image alt text — routes to data.alt on image nodes."},"src":{"type":"string","description":"Shorthand for image src — routes to data.src on image nodes. Ignored otherwise."},"href":{"type":"string","description":"Shorthand for link destinations — routes to data.href for button/link/nav-link, data.linkHref for banner-bar. Ignored for node types that don't link."},"text":{"type":"string","description":"Shorthand for the primary text content of the node — auto-routes to the right data field based on node type (data.text for heading/button/link/nav-link/banner-bar; data.content for text/rich-text/blockquote/callout; data.label for nav-link's label). This is the right field for 'change the copy' patches; you do NOT need to know the internal field name."},"node_id":{"type":"string","minLength":1,"description":"The id of the node to patch (matches Node.id in the tree)."},"data_patch":{"type":"object","description":"Escape hatch for other props (e.g. level on heading, variant on button, items on accordion). Keys are validated against the node type's primitive schema — unknown keys are rejected, so you can't corrupt the node by sending fields the renderer doesn't expect. Use the shorthands above for typical text/link/image changes.","additionalProperties":{}},"style_patch":{"type":"object","description":"Partial Node.style — shallow-merged into the existing style object.","additionalProperties":{}}},"additionalProperties":false},"maxItems":200,"minItems":1,"description":"Array of patches, each targeting a node by id. All applied as ONE new draft version. If any patch references a node that doesn't exist in the current fixture, the whole batch fails — fix the bad patch and retry the whole list. Each node_id may appear at most once; merge multiple patches for the same node into a single entry before sending."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"patch_fixture","title":"Restructure site","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Apply an RFC 6902 JSON Patch (array of add/remove/replace ops) to the latest fixture snapshot for a site, then save the result as a draft version. Use this when you need precise multi-field edits across the fixture (theme tokens + a couple of nodes + a header swap) without shipping the full fixture again. Paths are JSON Pointers (e.g. '/theme/config/colors/primary' or '/pages/0/tree/children/2'). Returns the preview URL. Call screenshot_page if you want to see the result.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","json_patch"],"properties":{"site_id":{"type":"string","format":"uuid"},"json_patch":{"type":"array","items":{"type":"object","required":["op","path"],"properties":{"op":{"enum":["add","remove","replace"],"type":"string"},"path":{"type":"string"},"value":{}},"additionalProperties":false},"maxItems":200,"minItems":1,"description":"RFC 6902 JSON Patch — array of {op, path, value?} operations. Supported ops: add, remove, replace. Paths are JSON Pointers (e.g. '/pages/0/tree/children/0/data/text'). Applied in order against the latest fixture snapshot."}},"additionalProperties":false}},{"name":"remove_nodes","title":"Refine layout","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Delete many nodes from a site in ONE call, batched into one new draft version. Locate each node_id across pages + siteElements and splice it out of its parent's children array. Use this for structural subtraction — dropping a testimonials section, removing a nav link, cutting one card from a grid, removing a header/footer column — whenever the brief calls for the template's layout minus something. Safe alternative to patch_fixture's JSON-Patch 'remove' ops for the same purpose: no hand-constructed paths, validated against the actual tree, and rejects root-node removal so you can't nuke a whole page. If a node id isn't found, the whole batch is rejected (fix and retry). Up to 50 removals per call.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","node_ids"],"properties":{"site_id":{"type":"string","format":"uuid"},"node_ids":{"type":"array","items":{"type":"string","minLength":1},"maxItems":50,"minItems":1,"description":"Array of node ids to remove from the fixture. The tool locates each across pages + siteElements and splices it from its parent. All removals apply as ONE new draft version. Root nodes (page tree root, header root, footer root, pageLayout root) cannot be removed — use delete_page for that. Each node_id may appear at most once. Max 50 per call."}},"additionalProperties":false}},{"name":"insert_nodes","title":"Add sections","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Add many nodes to a site in ONE call, batched into one new draft version. Each insertion is {parent_id, position, node}: parent_id locates an existing parent anywhere in the fixture (pages + siteElements), position is 'start' | 'end' | {after_id}, and node is the subtree to splice in. Use this for structural addition — adding a new section to a page, inserting a nav link, adding a card to a grid, restoring a container that was accidentally removed. Safe alternative to patch_fixture's JSON-Patch 'add' ops: no hand-constructed paths, validated parent + unique-id checks, and the subtree goes through the same primitive schema as any other node. Use list_primitives + get_primitive_schema to shape the new node's data. If a parent or after_id is missing, or a new id collides, the whole batch is rejected. Up to 50 insertions per call.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","insertions"],"properties":{"site_id":{"type":"string","format":"uuid"},"insertions":{"type":"array","items":{"type":"object","required":["parent_id","position","node"],"properties":{"node":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","minLength":1,"description":"Unique id for the new node. Must not collide with any existing node in the fixture — collision rejects the whole batch."},"data":{"type":"object","additionalProperties":{}},"type":{"type":"string","minLength":1,"description":"Primitive type (heading, text, image, button, section, container, stack, grid, etc). See list_primitives."},"extra":{"type":"object","additionalProperties":{}},"style":{"type":"object","additionalProperties":{}},"children":{"type":"array","items":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","minLength":1,"description":"Unique id for the new node. Must not collide with any existing node in the fixture — collision rejects the whole batch."},"data":{"type":"object","additionalProperties":{}},"type":{"type":"string","minLength":1,"description":"Primitive type (heading, text, image, button, section, container, stack, grid, etc). See list_primitives."},"extra":{"type":"object","additionalProperties":{}},"style":{"type":"object","additionalProperties":{}},"children":{"type":"array","items":{"$ref":"#/properties/insertions/items/properties/node/properties/children/items"}}},"additionalProperties":false}}},"description":"The node subtree to insert. Must include id and type; data/style/children/extra are optional.","additionalProperties":false},"position":{"anyOf":[{"type":"string","const":"start"},{"type":"string","const":"end"},{"type":"object","required":["after_id"],"properties":{"after_id":{"type":"string","minLength":1,"description":"Id of the sibling to insert after. The new node becomes the next child of the same parent."}},"additionalProperties":false}],"description":"Where in the parent's children to place the new node: 'start', 'end', or { after_id: '...' } to insert after a specific sibling."},"parent_id":{"type":"string","minLength":1,"description":"Id of the parent node to insert under. Parent must exist in the fixture and must support children (layout nodes: section, container, stack, grid, columns, page, header, footer, nav-links, etc)."}},"additionalProperties":false},"maxItems":50,"minItems":1,"description":"Array of insertions, each placing a new node under a parent. All applied as ONE new draft version. If any parent_id is missing, or any new node id collides with an existing id, or position.after_id doesn't match an existing child of parent_id, the whole batch is rejected. Up to 50 insertions per call."}},"additionalProperties":false}},{"name":"insert_tree","title":"Insert a custom section","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Insert a bespoke node subtree (provided as a JSON string) under an existing parent, as one new draft version. The editor-chat escape hatch for structure that add_section's flat archetypes can't express — layered hero stacks, two-tone headline row-stacks, asymmetric columns, custom nesting. Runs the same validation as insert_nodes (unique ids, primitive data-shape, parent must accept children) and rejects without saving if the subtree is malformed. For standard sections, use add_section instead — it's simpler and less error-prone. Use list_primitives + get_primitive_schema to shape node data correctly.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","parent_id","position","node_json"],"properties":{"site_id":{"type":"string","format":"uuid"},"after_id":{"type":"string","description":"Required when position is 'after': the id of the sibling to insert the new subtree after."},"position":{"enum":["start","end","after"],"type":"string","description":"Where among the parent's children to place the subtree: 'start', 'end', or 'after' a specific sibling (set after_id)."},"node_json":{"type":"string","maxLength":200000,"minLength":2,"description":"The new node subtree, as a JSON STRING. Shape: {\"id\":\"unique-id\",\"type\":\"section\",\"data\":{...},\"style\":{...},\"children\":[...]}. Every id must be globally unique (collisions are rejected). Follow the renderer rules: section>container>stack hierarchy, theme tokens var(--color-X) (never raw hex), Lucide icon names (never inline svg), two-tone headlines as a row stack of a heading + sibling text (never an inline ), responsive grid columns as {\"sm\":1,\"md\":2,\"lg\":3}. PREFER add_section for standard sections (hero, testimonials, pricing, faq, stats, etc.) — only reach for insert_tree when the design needs bespoke structure those archetypes cannot express."},"parent_id":{"type":"string","minLength":1,"description":"Id of an existing layout node to insert under — must accept children (section / container / stack / grid / columns / page / header / footer / nav-links / link-block). Find ids via get_site_overview."}},"additionalProperties":false}},{"name":"add_section","title":"Add a section","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"$73","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","page_slug","kind"],"properties":{"body":{"type":"string","description":"Supporting paragraph (hero subtitle / content body / cta body)."},"kind":{"enum":["hero","features","content","cta","gallery","testimonials","stats","pricing","faq","logo-strip","pull-quote","team-grid","split-image-text","process-steps","feature-split","newsletter","comparison","metrics-band","banner-cta","contact-form"],"type":"string","description":"$74"},"items":{"type":"array","items":{"type":"object","properties":{"body":{"type":"string","description":"Card / row body: feature copy, FAQ answer, testimonial quote, team bio, step description, pricing blurb, comparison 'with-us' line."},"icon":{"type":"string","description":"Lucide icon name for a feature / process / feature-split row, e.g. 'zap', 'shield', 'check'."},"meta":{"type":"string","description":"Secondary line: role/company (team, testimonial), or the 'without-us' line for the comparison kind."},"label":{"type":"string","description":"Caption under a stats / metrics value, e.g. 'Teams in production'."},"price":{"type":"string","description":"Price string for a pricing tier, e.g. '$29' or 'Free'."},"title":{"type":"string","description":"Card / row title: feature heading, FAQ question, team member name, pricing tier name, step title, gallery image alt."},"value":{"type":"string","description":"Big display number for stats / metrics-band, e.g. '250+', '$42M', '99.9%'. A leading prefix and trailing suffix animate around the count-up."},"period":{"type":"string","description":"Billing period suffix for a pricing tier, e.g. '/mo', '/seat'."},"cta_href":{"type":"string","description":"Per-item button href (defaults to '#')."},"featured":{"type":"boolean","description":"Mark a pricing tier as the recommended / highlighted one."},"cta_label":{"type":"string","description":"Per-item button label (pricing tier CTA)."},"image_url":{"type":"string","description":"Image URL — gallery image, team photo, logo (logo-strip), or testimonial avatar."}},"additionalProperties":false},"maxItems":12,"description":"Repeated flat cards/rows — meaning depends on `kind` (feature cards, gallery images, testimonials, stats, pricing tiers, FAQ pairs, logos, team members, process steps, comparison rows, metrics). Up to 12."},"eyebrow":{"type":"string","description":"Small label above the heading (hero/features)."},"heading":{"type":"string","description":"Section heading / hero headline."},"site_id":{"type":"string","format":"uuid"},"position":{"enum":["start","end"],"type":"string","description":"Where on the page to add it. Default 'end'."},"image_url":{"type":"string","description":"Single image URL (reserved for image-led kinds)."},"page_slug":{"type":"string","minLength":1,"description":"Slug of the page to add the section to, e.g. '/' or '/about'. Must be an existing page."},"primary_cta_href":{"type":"string","description":"Primary button href (defaults to '#')."},"primary_cta_label":{"type":"string","description":"Primary button label (hero/cta)."},"secondary_cta_href":{"type":"string","description":"Secondary button href."},"secondary_cta_label":{"type":"string","description":"Secondary button label (hero/cta)."}},"additionalProperties":false}},{"name":"reset_draft","title":"Reset draft to published","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true,"destructiveHint":true},"description":"REJECT the draft: throw away every saved-but-unpublished change and make the working copy identical to the currently published version (the inverse of publish_site). Use when the user dislikes the drafted changes they reviewed on the preview URL and wants to start over from what's live — \"scrap those changes\", \"go back to the live version\". Whole-site operation across the shell, pages, and collection items; deliberately-unpublished pages/items keep their drafts. previous_live is untouched, so revert_site (undo last publish) remains available. Returns reset=false when the site has never been published — there is nothing to reset to, and resetting would be meaningless (the draft is the only copy). DESTRUCTIVE for the draft: requires confirm=true; ask the user before calling.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","confirm"],"properties":{"confirm":{"type":"boolean","description":"Must be true. Resetting throws away every saved-but-unpublished change on the site — confirm with the user first."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"move_nodes","title":"Reorder layout","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Move a node to a new position in its page/element tree — reorder it within its current parent (e.g. push a section to the top) or re-parent it under a different container in the SAME tree. This is the safe reordering primitive: it takes node ids (not brittle JSON-Patch index paths) and is validated against the actual tree. position is 'start' / 'end' / { after_id }. Rejects moving a root node, moving a node into itself or its own descendant, and cross-tree moves (use duplicate_page / insert_nodes for those). Writes one new draft version.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","node_id","target_parent_id","position"],"properties":{"node_id":{"type":"string","minLength":1,"description":"Id of the node to move."},"site_id":{"type":"string","format":"uuid"},"position":{"anyOf":[{"type":"string","const":"start"},{"type":"string","const":"end"},{"type":"object","required":["after_id"],"properties":{"after_id":{"type":"string","minLength":1}},"additionalProperties":false}],"description":"Where under the target parent: 'start', 'end', or { after_id } to place it immediately after an existing child of that parent."},"target_parent_id":{"type":"string","minLength":1,"description":"Id of the parent the node should move under. Must live in the SAME page/element tree as node_id."}},"additionalProperties":false}},{"name":"get_site_overview","title":"Get site overview","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Abstracted site map — pages, collection items, theme tokens, per-page section types and headlines — without dumping the full primitive tree. Also reports PUBLISH STATE: the `publish` digest (is_live, shell state, per-kind live/edited/draft counts, has_unpublished_changes) plus a `state` ('live'|'edited'|'draft') on every page and collection item — use it to answer \"what's live?\" / \"is anything unpublished?\". For the full nested node tree (ids + nesting, minus props), call get_site_tree.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"get_site_tree","title":"Read the page structure","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Return the STRUCTURAL node tree of a page — the container hierarchy (sections, columns, cards, groups) and every node's id + type + a short text label — WITHOUT the full props payload, so it stays small. Use this when you need to target a CONTAINER, not just text: moving a section, restyling a column, inserting a child, or removing a block. get_site_overview gives a flat list of text nodes (great for copy edits but it drops containers); get_site returns only page/theme/publish summary (no node tree). get_site_tree is the one that gives the full nesting with ids, minus the props. Reads the DRAFT version. Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"slug":{"type":"string","description":"Page slug to read the structure of (e.g. '/' or '/about' or '/work'). Defaults to the home page '/'."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"read_rendered_page","title":"Read the rendered page","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Fetch a page's SERVER-RENDERED text via the preview URL — the visible copy, headings, and (for collection/list pages) the expanded items — without taking a screenshot. Use this to VERIFY what actually rendered: that your edits show up, a heading reads right, or a blog/collection index actually expanded its items. It's cheaper and more reliable than screenshot_page (no headless browser) and is the read-side pair to get_site_tree: get_site_tree shows the STRUCTURE, this shows the RENDERED CONTENT. Reads the draft via the preview URL. Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"slug":{"type":"string","description":"Page slug to read (e.g. '/' or '/blog' or '/blog/my-post'). Defaults to '/'."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"get_collection_tokens","title":"List a collection's template tokens","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Return EXACTLY what you can interpolate in a collection's row/detail template ({{…}} placeholders): every declared content field PLUS the auto-exposed route tokens `{{slug}}` (the item's slug) and `{{url}}` (the full detail path, pathPrefix + slug). Call this before writing a collection template so you don't guess a token that silently resolves to empty — the classic dead-link bug is writing href=\"/blog/{{slug}}\" without knowing slug is a valid token. Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type"],"properties":{"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1,"description":"The collection's content_type slug, e.g. 'blog' or 'projects'."}},"additionalProperties":false}},{"name":"preview_collection_item","title":"Dry-run a collection detail render","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Render a collection's DETAIL template against one specific draft item and return the resulting text + links + any problems — WITHOUT a browser and WITHOUT publishing. Use it right after add_content_item / editing a template to catch silent-success bugs before they go live: unresolved {{placeholders}}, and links that still contain braces. Complements get_site_tree (structure) and read_rendered_page (live SSR text). Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","slug"],"properties":{"slug":{"type":"string","minLength":1,"description":"The item's slug (its last path segment, e.g. 'my-post')."},"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1}},"additionalProperties":false}},{"name":"get_site_brief","title":"Get site brief","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Read the durable design brief for a site — vibe, category, brand voice, palette name, fonts, tagline, audience, the last 20 design decisions, AND a `design_system` block auto-extracted from the latest fixture (theme colors, typography pair, spacing scale, dominant section padding, icon density, section shape variety). Use this at the START of any editing session to recover context — it tells you what the site's design language already is so subsequent edits stay consistent. Returns has_brief=false when no brief has been saved yet.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"get_site_changes_since","title":"Get site changes since a snapshot","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Compact diff between a named snapshot (live or previous) and the current draft. Lists added/removed pages, pages whose tree changed, and whether the theme or shared header/footer changed. Use this to summarize what's pending publish (since='live') or everything that's happened including the last publish (since='previous'), instead of dumping full snapshots.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","since"],"properties":{"since":{"enum":["live","previous"],"type":"string","description":"Which snapshot to compare against the current draft. 'live' = what's currently published (use this to summarize pending edits before publishing). 'previous' = the snapshot live before the most recent publish (use this to summarize everything that's happened including the last publish)."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"rephrase_all_copy","title":"Rephrase all copy (prepare batch rewrite)","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"$75","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","instructions"],"properties":{"site_id":{"type":"string","format":"uuid","description":"The site UUID to scan for rewriteable copy."},"max_items":{"type":"integer","default":200,"maximum":2000,"minimum":1,"description":"Cap on returned items. Defaults to 200."},"instructions":{"type":"string","maxLength":1000,"minLength":1,"description":"Free-form rewrite instructions returned to the caller verbatim — e.g. 'make the copy more formal' or 'shorten everything by 30%'. This tool itself does NOT call an LLM; it returns the items so the MCP caller (Claude) can compose the rewrites and ship them via patch_fixture."}},"additionalProperties":false}},{"name":"apply_brand","title":"Set brand identity","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Apply a partial brand spec to a site — any subset of {primary, accent, background, text, font_family, heading_family, name, tagline}. Color fields merge into theme.colors; font fields merge into theme.typography. Omitted fields are preserved. If `name` or `tagline` is provided, also best-effort updates the site brief (metadata.brief). Saves as a draft and returns the preview URL. Call screenshot_page if you want to see the result.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","brand"],"properties":{"brand":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"minLength":1,"description":"Optional brand name. When provided, also written to the site brief (metadata.brief.tagline) and palette_name = 'Custom'."},"text":{"$ref":"#/properties/brand/properties/primary","description":"Primary text color (maps to colors.text.primary)."},"accent":{"$ref":"#/properties/brand/properties/primary","description":"Brand accent color."},"primary":{"type":"string","maxLength":64,"minLength":1,"description":"Brand primary color (hex/rgb/css)."},"tagline":{"type":"string","maxLength":500,"minLength":1,"description":"Optional tagline. Written to metadata.brief.tagline if set."},"background":{"$ref":"#/properties/brand/properties/primary","description":"Page background color."},"font_family":{"type":"string","maxLength":200,"minLength":1,"description":"Body font family (CSS font-family value)."},"heading_family":{"type":"string","maxLength":200,"minLength":1,"description":"Heading font family. Defaults to font_family if omitted."}},"additionalProperties":false},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"apply_palette","title":"Tune palette","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Replace the site's color palette. Two modes: (1) explicit spec — required: primary, secondary, accent, background, surface, text; optional: text_secondary, text_muted, border. (2) preset_name — re-apply a preset saved with save_theme_preset (colors + typography); any explicit palette fields override the preset's values. The flat `text` field maps to colors.text.primary; any colors not listed (e.g. semantic.success, selection.background) are preserved from the base theme. Optionally also set typography in the same call via heading_family / body_family (supported Google Fonts load via the platform bundle; unsupported names warn — omit to leave fonts unchanged). Saves as a draft and returns the preview URL. Call screenshot_page if you want to see the result.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"palette":{"type":"object","properties":{"text":{"$ref":"#/properties/palette/properties/primary","description":"Body text (maps to colors.text.primary in the theme)."},"accent":{"$ref":"#/properties/palette/properties/primary","description":"Brand accent."},"border":{"$ref":"#/properties/palette/properties/primary","description":"Optional. Maps to colors.border."},"primary":{"type":"string","maxLength":64,"minLength":1,"description":"Brand primary."},"surface":{"$ref":"#/properties/palette/properties/primary","description":"Card/surface background."},"secondary":{"$ref":"#/properties/palette/properties/primary","description":"Brand secondary."},"background":{"$ref":"#/properties/palette/properties/primary","description":"Page background."},"text_muted":{"$ref":"#/properties/palette/properties/primary","description":"Optional. Maps to colors.text.muted."},"text_secondary":{"$ref":"#/properties/palette/properties/primary","description":"Optional. Maps to colors.text.secondary."}},"description":"Color spec. Without preset_name all six core tokens are required; with preset_name every field is optional and overrides the preset.","additionalProperties":false},"site_id":{"type":"string","format":"uuid"},"body_family":{"type":"string","maxLength":200,"minLength":1,"description":"Optional body font family (CSS font-family value). Maps to typography.fontFamily; use a supported Google Font (bundle-loaded)."},"preset_name":{"type":"string","maxLength":120,"minLength":1,"description":"Name (or slug) of a saved theme preset from save_theme_preset. Loads that preset's colors + typography; explicit palette fields override the preset's values."},"heading_family":{"type":"string","maxLength":200,"minLength":1,"description":"Optional heading font family (CSS font-family value). Use a supported Google Font (the platform bundle loads it); unsupported names warn."}},"additionalProperties":false}},{"name":"save_theme_preset","title":"Save theme preset","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"description":"Snapshot the site's CURRENT draft theme (colors + typography) into fixture.themePresets[] as a named preset you can re-apply later with apply_palette(preset_name). Pass optional color/typography overrides (primary, accent, background, heading_family, body_family, etc.) to save a tweaked variant without first applying it; omitted overrides keep the current draft values. Saving with an existing preset name REPLACES that preset (no duplicates); max 20 presets per site. Does NOT change the active theme — the draft renders the same before and after.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"description":"Display name for the preset (used to re-apply it via apply_palette's preset_name). Defaults to 'Preset N' where N is the next index. Re-saving with an existing name replaces that preset."},"text":{"$ref":"#/properties/primary","description":"Override body text color (colors.text.primary)."},"accent":{"$ref":"#/properties/primary","description":"Override accent color."},"border":{"$ref":"#/properties/primary","description":"Override colors.border."},"primary":{"type":"string","maxLength":64,"minLength":1,"description":"Override primary color."},"site_id":{"type":"string","format":"uuid"},"surface":{"$ref":"#/properties/primary","description":"Override surface color."},"secondary":{"$ref":"#/properties/primary","description":"Override secondary color."},"background":{"$ref":"#/properties/primary","description":"Override background color."},"text_muted":{"$ref":"#/properties/primary","description":"Override colors.text.muted."},"body_family":{"$ref":"#/properties/heading_family","description":"Override body font family (typography.fontFamily)."},"heading_family":{"type":"string","maxLength":200,"minLength":1,"description":"Override heading font family (typography.headingFamily)."},"text_secondary":{"$ref":"#/properties/primary","description":"Override colors.text.secondary."}},"additionalProperties":false}},{"name":"site_health_check","title":"Site health check","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Walk the latest fixture for a site and surface quality issues — missing image alt text, broken/empty links, empty sections, orphaned pages, missing SEO titles. Returns a 0-100 score and a list of issues so you can quickly recommend fixes.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"suggest_next_step","title":"Suggest next step","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Look at a site's current shape (pages, sections, header nav) and recent activity (form submissions over 30 days) and return up to 3 prioritized suggestions for what to add or fix next. Use this when the user asks 'what should I do next' or after major edits.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"explain_design","title":"Explain design","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Explain the design choices of a site or a specific node. With node_id, returns layout role, color/typography choices, semantic intent, and related theme tokens. Without node_id, summarizes the site's overall design language. No LLM call — pure structural analysis.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"node_id":{"type":"string"},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"summarize_recent_activity","title":"Summarize recent activity","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"One-shot summary of a site's recent activity (default last 7 days, max 90): form submissions broken down by form_type, new contacts, pageviews + uniques, top 3 pages, top 3 referrers. Use this when the user asks 'how's my site doing this week?'. Pro-only because the analytics block reads the same Pro-gated data as get_analytics — for free sites, use list_submissions / list_contacts directly instead.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"days":{"type":"integer","default":7,"maximum":90,"minimum":1},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"draft_reply_to_submission","title":"Draft reply to submission","annotations":{"readOnlyHint":true,"openWorldHint":false},"description":"Returns the original form submission plus a structured reply template (subject, greeting, body, sign-off) for you to adapt into a tailored response. This tool composes a TEMPLATE only — it does not send anything. Use list_submissions to find the submission_id first.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["submission_id"],"properties":{"submission_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"top_pages","title":"Top pages","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Return the most-viewed pages for a site over a trailing window (default 30 days, max 90), with views, unique visitors, and share-of-traffic percentage. Useful for conversion conversations: 'these are the pages doing work — focus your CTA tweaks here'. Pro-only — free sites get a billing_gate response with the upgrade URL.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"},"period_days":{"type":"integer","default":30,"maximum":90,"minimum":1}},"additionalProperties":false}},{"name":"set_custom_domain","title":"Attach a custom domain","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":true},"description":"Attach a custom hostname (e.g. `example.com`, `www.example.com`, `app.example.com`) to a Sitelas site. Registers the domain with the CDN, stores it against the site, and returns the EXACT DNS records the user needs to add at their registrar — apex domains get an A record (76.76.21.21) plus a www CNAME, subdomains get a single CNAME. Records are returned both structured (`dns_records`) and as a copy-pasteable human-readable list (`dns_instructions`). Relay `dns_instructions` and `next_step` verbatim. After DNS propagates (5–30 min typical), call `verify_custom_domain` to flip the verified flag.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","domain"],"properties":{"domain":{"type":"string","pattern":"^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\\.[a-zA-Z]{2,}$","maxLength":253,"minLength":4,"description":"Apex or subdomain hostname like `example.com` or `www.example.com`. Do NOT include a protocol (`https://`) or trailing slash."},"site_id":{"type":"string","format":"uuid","description":"The site UUID to attach the custom domain to."}},"additionalProperties":false}},{"name":"list_custom_domains","title":"List custom domains","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List custom domains attached to a Sitelas site. Each entry includes the hostname, whether DNS verification has succeeded, the verification token (when one exists), and when the domain was attached. Use `set_custom_domain` to attach a new domain and `verify_custom_domain` to re-check verification.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"The site UUID to list attached custom domains for."}},"additionalProperties":false}},{"name":"verify_custom_domain","title":"Verify custom domain DNS","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":true},"description":"Re-check DNS for a custom domain and flip the verified flag if Vercel confirms the records resolve. Call this after the user updates DNS at their registrar. On success, returns the live HTTPS URL the user can open. On failure, returns Vercel's specific reason plus the exact records Vercel expected — surface `expected_records` so the user can spot the mismatch (wrong host, wrong target, missing record). Surface `message` verbatim either way.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","domain"],"properties":{"domain":{"type":"string","pattern":"^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\\.[a-zA-Z]{2,}$","maxLength":253,"minLength":4,"description":"Hostname to re-verify (e.g. `example.com`)."},"site_id":{"type":"string","format":"uuid","description":"The site UUID the domain is attached to."}},"additionalProperties":false}},{"name":"delete_custom_domain","title":"Remove a custom domain","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":true,"destructiveHint":true},"description":"Remove a custom domain from a Sitelas site. Detaches the domain from the Vercel project (apex + www) and deletes the row from custom_domains. Use when the user wants to free up a typo'd domain to re-attach, swap to a different domain, or stop serving traffic on a custom hostname (the *.sitelas.com subdomain keeps working). Requires `confirm: true` to be deliberate. After deletion, the user should remove the DNS records from their registrar — Sitelas can't do that for them.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","domain","confirm"],"properties":{"domain":{"type":"string","pattern":"^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\\.[a-zA-Z]{2,}$","maxLength":253,"minLength":4,"description":"Hostname to remove. Must match the exact domain stored against this site."},"confirm":{"type":"boolean","const":true,"description":"Required boolean — pass `true` to confirm. Forces deliberate removal: the domain is detached from the Vercel project AND deleted from Sitelas's records."},"site_id":{"type":"string","format":"uuid","description":"The site UUID the domain is attached to."}},"additionalProperties":false}},{"name":"update_seo","title":"Optimize for search","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Set SEO metadata for a site or a specific page. Per-page mode (with `page_slug`) writes into the page's `metadata.seo` and ships as a new draft version — call `publish_site` to push live. Site-wide mode (no `page_slug`) writes into `subdomains.metadata.seo` and applies immediately to pages that don't set their own values. Supported fields: title, description, og_image_url, robots (index|noindex).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","seo"],"properties":{"seo":{"type":"object","properties":{"title":{"type":"string","maxLength":200,"minLength":1,"description":"SEO title. Per-page: overrides the page's default title in the tag and og:title. Site-level: applied as a default to pages that don't set their own."},"robots":{"enum":["index","noindex"],"type":"string","description":"Search-engine indexing directive. `noindex` keeps the page out of Google."},"description":{"type":"string","maxLength":500,"minLength":1,"description":"Meta description. Used in <meta name=\"description\">, og:description, and twitter:description."},"og_image_url":{"type":"string","format":"uri","description":"Public URL for the OpenGraph share image. Use `upload_image_from_url` or `upload_image_from_data` to host one if you don't have a stable URL."}},"description":"SEO fields to set. Only the provided fields are updated; omitted fields are left untouched.","additionalProperties":false},"site_id":{"type":"string","format":"uuid","description":"The site UUID to update SEO for."},"page_slug":{"type":"string","maxLength":200,"minLength":1,"description":"Page slug to update (e.g. `/about`). When omitted, applies the SEO values as site-wide defaults that fall through to pages without their own overrides."}},"additionalProperties":false}},{"name":"generate_sitemap","title":"Map site for search engines","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Build a sitemap.xml from a site's currently published version. Walks enabled pages and emits one <url> entry per page using the site's live URL (custom domain when verified, otherwise the *.sitelas subdomain). Returns the raw XML plus a parsed entries array. Read-only — does not mutate the site. Sitelas may already auto-serve a sitemap; use this tool to inspect or copy the generated XML.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"The site UUID to build a sitemap for."}},"additionalProperties":false}},{"name":"record_decision","title":"Record decision","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Append a durable decision (with optional rationale) to the site's cross-session memory. Use this whenever you make a non-obvious creative or structural choice the user might want to revisit later — palette swap, copy direction, layout approach, etc. Capped at 50 entries per site (oldest dropped). Returns the new total count and the timestamp recorded.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","decision"],"properties":{"why":{"type":"string","maxLength":500},"site_id":{"type":"string","format":"uuid"},"decision":{"type":"string","maxLength":500,"minLength":1}},"additionalProperties":false}},{"name":"update_site_brief","title":"Update site brief","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Set or incrementally update the durable site brief (vibe, category, brand voice, palette/font names, tagline, target audience) used as cross-session memory. Merges field-by-field into the existing brief — omitted fields are preserved, and the decisions[] log is left untouched. Call this once after picking a direction, then again whenever the direction shifts.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","brief"],"properties":{"brief":{"type":"object","properties":{"vibe":{"type":"string","maxLength":500},"tagline":{"type":"string","maxLength":500},"category":{"type":"string","maxLength":500},"font_pair":{"type":"string","maxLength":500},"brand_voice":{"type":"string","maxLength":500},"palette_name":{"type":"string","maxLength":500},"target_audience":{"type":"string","maxLength":500}},"additionalProperties":false},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"list_content_types","title":"List content types","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List every content collection declared on a site, with its per-item field schema (`fields[]`). Schemas are per-site — there is no platform-wide catalog. Each entry includes the collection's `contentType` slug, its `pathPrefix`, whether it's enabled, and the typed `fields[]` (each with `key`, `type`, optional `required`, `label`, `description`, `options` for select fields), PLUS `observed_fields` — keys that actually appear on the collection's items but aren't in the declared schema (the schema is open, so include these when adding an item so it matches the existing ones). Call this before `add_content_item` to discover which fields a collection supports — or before `create_collection` to confirm a contentType isn't already taken.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid","description":"Site whose collection catalog to list. Each site has its own schemas — there is no platform-wide catalog."}},"additionalProperties":false}},{"name":"create_collection","title":"Create collection","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Stand up a new collection on an existing site in one call: append a `collections[]` entry (with `contentType`, `pathPrefix`, `template`, and optional `items[]`), optionally create the index page that hosts the matching `<collection-list>`, and seed initial items into the `content_items` table. After this call:\n - `/{path_prefix}/{slug}` resolves each item via Mustache substitution\n - the index page's `<collection-list>` iterates the seeded items\n - `add_content_item` / `edit_content_item` / `delete_content_item` manage rows afterward.\n\nUse this when the user asks 'add a blog to my site', 'set up case studies', 'add a careers section', etc. Schemas are per-site — pick a `contentType` slug that's unique within the site (call list_content_types to see what's already declared) and ship the `fields[]` schema inline. Writes a new draft version; call publish_site to push live.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","path_prefix","fields","template"],"properties":{"items":{"type":"array","items":{"type":"object","required":["slug","content"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1},"content":{"type":"object","additionalProperties":{}},"visibility":{"enum":["public","private"],"type":"string"}},"additionalProperties":false},"description":"Initial items to seed into content_items. Each row's content must satisfy the collection's `fields` (required fields populated, declared types matched). The index page's <collection-list> will iterate these."},"fields":{"type":"array","items":{"type":"object","required":["key","type"],"properties":{"key":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]*$","maxLength":80,"minLength":1},"type":{"enum":["text","textarea","rich-text","number","boolean","url","date","image","tags","select"],"type":"string"},"label":{"type":"string","maxLength":120},"default":{},"options":{"type":"array","items":{"type":"string"}},"required":{"type":"boolean"},"maxLength":{"type":"integer","exclusiveMinimum":0},"description":{"type":"string","maxLength":400},"placeholder":{"type":"string","maxLength":200}},"additionalProperties":false},"minItems":1,"description":"Per-item field schema. Each field becomes a form input AND a write-time validation rule. Include every field the `template` references (placeholders like {{title}}, {{body}}, {{image.url}} map to field keys). The schema is per-site and per-collection — there is no global catalog."},"enabled":{"type":"boolean","description":"Defaults to true. Set false to ship the collection definition (template + items) without serving detail URLs or rendering index iteration."},"site_id":{"type":"string","format":"uuid"},"template":{"type":"object","description":"Per-item template Node tree with {{field}} placeholders. The template is rendered for each detail URL with the row's content substituted in. See the canonical examples in lib/fixtures/templates/hatch.json, prive.json, narrative.json for the shape.","additionalProperties":{}},"index_page":{"type":"object","required":["slug","title","tree"],"properties":{"slug":{"type":"string","pattern":"^\\/[a-z0-9-]+$","description":"Slug for the index page (the listing page that hosts the <collection-list>). Typically the path_prefix without the trailing slash, e.g. '/blog'."},"tree":{"type":"object","description":"Index page Node tree, which should contain a <collection-list contentType=...> primitive whose first child is the per-row card template.","additionalProperties":{}},"title":{"type":"string","maxLength":200,"minLength":1}},"description":"Optional index page to create at the same time. If the site already has an index page at the prefix (e.g. /blog), omit this and patch its tree separately.","additionalProperties":false},"path_prefix":{"type":"string","pattern":"^\\/[a-z0-9-]+\\/$","description":"URL prefix for detail pages. Single segment, kebab-case, with leading and trailing slashes. Examples: '/blog/', '/projects/', '/searches/', '/case-studies/'."},"content_type":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$","maxLength":100,"minLength":1,"description":"The collection's per-site identifier (its content_type slug). Lowercase kebab-case. Each site owns its catalog — pick whatever name fits the brief (project, blog, recipe, episode, gift, …)."}},"additionalProperties":false}},{"name":"list_content_items","title":"List content items","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"List content items (e.g. blog posts, projects) for a site filtered by content_type slug. Optionally filter by visibility ('public' | 'private' | 'all'; default 'all'), with limit/offset paging. Returns each item's id, slug, full content JSON, visibility, and timestamps. Use add_content_item / edit_content_item / delete_content_item to mutate the collection.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type"],"properties":{"filters":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0},"visibility":{"enum":["public","private","all"],"type":"string","default":"all"}},"additionalProperties":false},"site_id":{"type":"string","format":"uuid"},"content_type":{"type":"string","minLength":1}},"additionalProperties":false}},{"name":"add_content_item","title":"Add to collection","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":true},"description":"$76","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","content_type","slug","content"],"properties":{"slug":{"type":"string","maxLength":200,"minLength":1,"description":"Single-segment kebab-case slug (lowercase alphanumeric + dashes, no slashes, no leading/trailing dashes). The DB enforces this via a CHECK constraint; invalid slugs are rejected at insert time."},"content":{"type":"object","additionalProperties":{}},"site_id":{"type":"string","format":"uuid"},"visibility":{"enum":["public","private"],"type":"string","default":"public"},"content_type":{"type":"string","minLength":1},"published_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp used as the item's `publishedAt` for ordering. Defaults to now if omitted (and left untouched if `content.publishedAt` is already set). Sort a collection-list newest-first with sortBy:'publishedAt', sortDir:'desc' — more reliable than created_at, which can tie on bulk/automated inserts."}},"additionalProperties":false}},{"name":"edit_content_item","title":"Edit content item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false},"description":"Update fields on an existing content item. Identify it by `item_id`, OR — when you only know its name — by `site_id` + `content_type` + (`slug` | `title`); `title` resolves fuzzily (exact then contains) and errors with the available titles when there's no unique match. `patch` may include `content` (shallow-merged into existing content JSON), `slug` (rename), and/or `visibility`. At least one field is required. When `content` is patched, the MERGED result is validated against the content_type schema (lenient: required present + declared types; extra fields allowed) and rejected with paths if it would leave the item missing a required field. Ownership is verified via the parent site's user_id. Throws on slug collision.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["patch"],"properties":{"slug":{"type":"string","description":"Exact item slug to resolve (with site_id + content_type)."},"patch":{"type":"object","properties":{"slug":{"type":"string","maxLength":200,"minLength":1},"content":{"type":"object","additionalProperties":{}},"visibility":{"enum":["public","private"],"type":"string"}},"additionalProperties":false},"title":{"type":"string","description":"Item title to resolve fuzzily (case-insensitive exact, then contains). Errors with the available titles if there's no unique match."},"item_id":{"type":"string","format":"uuid","description":"The item's UUID (from a content list)."},"site_id":{"type":"string","format":"uuid","description":"Site UUID — required when resolving by content_type + slug/title."},"content_type":{"type":"string","description":"Collection content type — required when resolving by slug/title."}},"additionalProperties":false}},{"name":"delete_content_item","title":"Delete content item","annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":true},"description":"Delete a content item by id. Ownership is verified via the parent site's user_id. Returns the deleted item's slug and content_type for confirmation.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["item_id"],"properties":{"item_id":{"type":"string","format":"uuid"}},"additionalProperties":false}},{"name":"screenshot_page","title":"Look at the site","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Capture a JPEG of any page on a site so you can SEE what you composed and adjust before composing more. Use mid-generation: after create_site_from_template or update_site_from_fixture, screenshot the page you just built and review the layout, spacing, color use, and hierarchy. If something's off, patch it via patch_nodes or update_site_from_fixture before continuing. Always screenshots via the preview URL (preview-{slug}.{rootDomain}) — it always renders the current draft (or 302s to live when in sync). Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"slug":{"type":"string","description":"Page slug to screenshot (e.g. '/' or '/about' or '/work/aperture'). Defaults to '/'."},"site_id":{"type":"string","format":"uuid"},"viewport":{"enum":["desktop","tablet","mobile"],"type":"string","description":"Render width for the shot: 'desktop' (1024, default), 'tablet' (820), or 'mobile' (390). Use 'mobile' to verify the responsive breakpoint — that columns collapse to one, headings don't overflow, etc."},"full_page":{"type":"boolean","description":"Capture the ENTIRE page top-to-bottom, not just the first screenful. Set true to verify content below the fold — a contact form, footer, or sections after the hero. Default false = fast top-only crop."}},"additionalProperties":false}},{"name":"critique_design","title":"Review design","annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true},"description":"Returns extracted design metrics for a site (per-page section signatures, CTA counts, heading hierarchy, placeholder text detection, site-wide color/font/spacing usage) for reviewing a site's design quality and producing a structured critique. Useful after composing or editing a site as a self-review pass, before claiming it's done. Different from site_health_check (which covers technical things like missing alt text, broken links). Read-only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id"],"properties":{"site_id":{"type":"string","format":"uuid"},"page_slug":{"type":"string","description":"Optional — focus the critique on a single page slug (e.g. '/about'). When omitted, returns metrics for all pages."}},"additionalProperties":false}},{"name":"delete_site","title":"Delete a site permanently","annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":true,"destructiveHint":true},"description":"Permanently delete a site — its subdomain row, all version snapshots, all content_items, all submissions, the alias history, attached custom domains (removed from Vercel), the Polar subscription (cancelled — Polar handles any refund), and any media in the storage bucket. IRREVERSIBLE. Use this when the user explicitly asks to scrap a site (e.g. 'delete my-portfolio-3947, I don't want it' or 'I created the wrong template, throw it away'). Requires `confirm: true` to be deliberate. Do NOT call this on user-said-something-vague — ask 'are you sure you want to delete {subdomain} permanently?' first and only call after explicit yes. There is no undo. If the Polar cancellation fails (network / Polar outage), the entire delete is aborted so the user is never charged for a deleted site.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["site_id","confirm"],"properties":{"confirm":{"type":"boolean","const":true,"description":"Required boolean — pass `true` to confirm. Forces Claude to be deliberate before destroying user data."},"site_id":{"type":"string","format":"uuid"}},"additionalProperties":false}}],"prompts":[],"resources":[],"triggers":[],"configSchema":null,"configAllowsEmpty":false},"className":"w-12 h-12 shrink-0"}],"$L77"]}],"$L78"]}],"$L79"]}]}],"$L7a"]}],"$L7b"]}]] </article></body></html>