Create a site from a brief
create_site_from_briefBUILD FIRST, ASK LATER. Creates a complete, live draft website in one call - free, instant, no account and no sign-in. Call this as soon as someone asks for a website, using whatever you already know and sensible defaults for the rest, then show them the returned preview_url and refine it with edit_section and set_theme. Do not interview the user first. Composition is deterministic and no language model is involved, so anything you leave blank renders as a visible placeholder rather than invented copy. You can edit or claim this draft for 7 days from creation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"business_name": "<business_name>"
},
"name": "create_site_from_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tagline | No | Short tagline/subheading, max 200 chars. | |
| sections | No | Comma-separated section kinds to include, in order, e.g. "hero,about,services,contact". Allowed values: hero, about, services, features, gallery, testimonials, pricing, faq, hours, contact, cta, footer, menu, map, social, header, products, reviews. Defaults to hero,about,services,contact when omitted. | |
| template | No | Optional starter template - the same ones people pick in the editor. storefront: products with buy buttons, why-us, shipping FAQ. event: a recurring night - what to expect, rules, sign-up, where. shop: a place to visit - story, hours, photos, map, socials. services: services with prices, reviews, service area, hours. nonprofit: mission, get involved, give. Your fields win: sections replace the template sections; content_json replaces it per kind, other kinds keep the sample text. business_name is still required. | |
| font_body | No | Body font family name. Defaults to Inter. | |
| site_name | No | Optional display name for the site row (defaults to business_name). | |
| draft_token | No | The draft token returned by draft_create, if you are working on an anonymous draft. Only needed when your client cannot send the x-pagetool-draft-token header. | |
| content_json | No | Per-section content, keyed by section kind (the kind must also be in sections), as a JSON string or an object, max 64KB. Keys per kind - hero: heading, body, ctaLabel, ctaHref, image, alt. about: heading, body, image, alt. cta: heading, body, ctaLabel, ctaHref. services / features / testimonials: heading, items[] of {title, body, href, linkLabel, image, alt}. pricing: heading, items[] of {title, body, price, href, linkLabel, image, alt}. gallery: heading, items[] of {image, alt, title}. faq: heading, items[] of {title, body} (question/q and answer/a are accepted for title/body). hours: heading, body. contact: heading, body. footer: none. menu: heading, items[] of {title, body, price, group} (grouped by group). map: heading, address (defaults to contact_address; embeds a Google map). social: heading, items[] of {title, href}. products: heading, items[] of {title, body, price, href, linkLabel, image, alt, soldOut} (a shop grid: photo, name, price and a Buy now button; soldOut true shows a Sold out badge instead of the button). reviews: heading, placeId (the business Google place id; live reviews show on Creator plans and up, at most 5, fetched from Google at view time; never write review text). header: none (a new site and a new page always start with one: the business name plus links to its sections). An item href renders a link (text = linkLabel, default "Learn more"; in pricing a button, default "Buy now"). Hrefs may be http(s), mailto:, tel:, /path or an in-page anchor like #pricing (every section gets its kind as its id). An image renders a photo with alt - use import_image first to get a hosted copy. Max 12 items per kind. Anything ignored, cut or dropped is listed in the response warnings array - read it. Example: {"hero":{"heading":"Fresh bread daily","body":"Baked before sunrise.","ctaLabel":"Order now","ctaHref":"/order"},"services":{"items":[{"title":"Sourdough","body":"24-hour ferment."},{"title":"Croissants","body":"All butter."}]}} | |
| font_heading | No | Heading font family name. Defaults to Inter. | |
| business_name | Yes | The business or site name. Required, max 120 chars. | |
| contact_email | No | Contact email shown in the contact section, if included. | |
| contact_phone | No | Contact phone shown in the contact section, if included. | |
| contact_address | No | Contact address shown in the contact section, if included. | |
| palette_neutral | No | Neutral text/background colour as a #rrggbb hex string. Defaults to #0f172a. | |
| palette_primary | No | Primary brand colour as a #rrggbb hex string. Defaults to #2563eb. |