Server definition
- Hash
- sha256:7a04ec517d637223c070b8b6153328f872f7037f0c66b6811dea3c40bda71cb6
- What it is
- What a remote MCP server returned when asked what it offers: 27 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Read a claimed account page without requiring an editToken. Use after OAuth when the user wants to manage a durable website.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"pageId": {
"description": "The claimed pageId to manage.",
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "account_page_manage",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "List landing pages claimed by the signed-in account. Safe to call without auth: an anonymous demo session gets ok=true with an empty list and authRequired=true (not an error) because it has no saved pages, so go straight to page_intake_start or page_create_from_brief. Sign-in is only needed afterwards to claim or manage a page.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum number of claimed pages to return.",
"maximum": 50,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"name": "account_pages_list",
"outputSchema": {
"additionalProperties": false,
"properties": {
"authRequired": {
"description": "true when the session is an anonymous demo: it has no saved pages, so pages is empty. Not an error.",
"type": "boolean"
},
"nextStep": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"pages": {
"items": {
"additionalProperties": false,
"properties": {
"claimedAt": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"isPublished": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishedUrl": {
"type": "string"
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
},
"required": [
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimedAt",
"createdAt",
"updatedAt"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok",
"pages"
],
"type": "object"
}
},
{
"description": "Return the current Create Web Page account context. Use this to check whether the user is authenticated or using an anonymous expiring demo.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "account_whoami",
"outputSchema": {
"additionalProperties": false,
"properties": {
"accountId": {
"type": "string"
},
"authMode": {
"enum": [
"internal",
"oauth",
"demo"
],
"type": "string"
},
"demoExpiresAt": {
"type": [
"string",
"null"
]
},
"role": {
"enum": [
"owner",
"demo"
],
"type": "string"
},
"service": {
"type": "string"
}
},
"required": [
"accountId",
"authMode",
"role",
"service",
"demoExpiresAt"
],
"type": "object"
}
},
{
"description": "Append a new content block to a link-in-bio page. The block must match one of the 13 allowed types (link, social_row, whatsapp, phone_call, email_contact, image, gallery, video_embed, text, map_embed, product_card, lead_form, reviews) with that type's strict props. The server generates the block id and returns it in the response. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down. The response includes nextSteps: after adding a block, share these hints with the user so they know what else would make the page more complete.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"block": {
"description": "The block to add. Must match one of the 14 allowed types with that type's strict props schema. The server generates the block id.",
"oneOf": [
{
"additionalProperties": false,
"description": "A tappable button with a label and URL. Optional thumbnail and icon.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"highlight": {
"type": "boolean"
},
"icon": {
"maxLength": 64,
"type": "string"
},
"label": {
"maxLength": 120,
"type": "string"
},
"thumbnail": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"url": {
"description": "Destination URL using http, https, mailto, tel, or sms.",
"maxLength": 2048,
"type": "string"
},
"width": {
"description": "half lets two consecutive half-width links render side by side as one row. Default full.",
"enum": [
"full",
"half"
],
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a link block.",
"enum": [
"link"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "A compact row of social icons. Items are { platform, url }.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 64,
"type": "string"
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"x",
"facebook",
"linkedin",
"spotify",
"apple_music",
"soundcloud",
"github",
"pinterest",
"threads",
"twitch",
"discord",
"telegram",
"snapchat",
"vimeo",
"behance",
"dribbble",
"medium",
"substack",
"website",
"other",
"email",
"phone",
"whatsapp"
],
"type": "string"
},
"url": {
"description": "For social platforms: a public http(s) profile URL. For contact platforms (email/phone/whatsapp): the bare email address or phone number — the page builds the mailto:/tel:/wa.me link.",
"type": "string"
}
},
"required": [
"platform",
"url"
],
"type": "object"
},
"maxItems": 16,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a social_row block.",
"enum": [
"social_row"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "WhatsApp CTA. Requires a WhatsApp number (digits only).",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"type": "string"
},
"message": {
"description": "Optional prefilled message.",
"maxLength": 500,
"type": "string"
},
"number": {
"description": "Public WhatsApp phone number.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"number"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a whatsapp block.",
"enum": [
"whatsapp"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Tel: button. Requires a phone number.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"type": "string"
},
"number": {
"description": "Public phone number.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"number"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a phone_call block.",
"enum": [
"phone_call"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Mailto: button. Requires an email address.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"email": {
"description": "Public business email address.",
"type": "string"
},
"label": {
"maxLength": 120,
"type": "string"
},
"subject": {
"maxLength": 160,
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a email_contact block.",
"enum": [
"email_contact"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "A single image with layout classic | wide | background.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"caption": {
"maxLength": 280,
"type": "string"
},
"image": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"layout": {
"enum": [
"classic",
"wide",
"background"
],
"type": "string"
},
"link_url": {
"maxLength": 2048,
"type": "string"
}
},
"required": [
"image"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a image block.",
"enum": [
"image"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Multiple images in a grid or carousel.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"display": {
"enum": [
"grid",
"carousel"
],
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"maxItems": 24,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a gallery block.",
"enum": [
"gallery"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "YouTube, Vimeo, or mp4. Use normalized provider + video_id.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"provider": {
"enum": [
"youtube",
"vimeo",
"mp4"
],
"type": "string"
},
"thumbnail": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"title": {
"maxLength": 160,
"type": "string"
},
"video_id": {
"description": "Video id or URL, depending on provider.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"provider",
"video_id"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a video_embed block.",
"enum": [
"video_embed"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "A short final-audience heading, body, and/or list block.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"alignment": {
"enum": [
"left",
"center"
],
"type": "string"
},
"body": {
"maxLength": 2000,
"type": "string"
},
"heading": {
"maxLength": 160,
"type": "string"
},
"items": {
"items": {
"maxLength": 280,
"type": "string"
},
"maxItems": 12,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a text block.",
"enum": [
"text"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Google Maps embed by address, place_id, or lat/lng.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Public business address or service-area text.",
"maxLength": 400,
"type": "string"
},
"label": {
"maxLength": 160,
"type": "string"
},
"lat": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"lng": {
"maximum": 180,
"minimum": -180,
"type": "number"
},
"place_id": {
"maxLength": 160,
"type": "string"
},
"zoom": {
"maximum": 20,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a map_embed block.",
"enum": [
"map_embed"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "A link-out commerce card with name, image, price, and buy URL.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"buy_url": {
"description": "Public http(s) purchase URL.",
"type": "string"
},
"cta_label": {
"maxLength": 120,
"type": "string"
},
"description": {
"maxLength": 280,
"type": "string"
},
"image": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"name": {
"maxLength": 160,
"type": "string"
},
"price_text": {
"maxLength": 40,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a product_card block.",
"enum": [
"product_card"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Capture form. mode: contact | newsletter | booking_interest. Supply field labels and submit text for localized public pages.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"consent_text": {
"maxLength": 400,
"type": "string"
},
"description": {
"maxLength": 280,
"type": "string"
},
"destination_email": {
"description": "Public/business lead recipient email.",
"type": "string"
},
"destination_webhook": {
"description": "Public http(s) webhook URL.",
"type": "string"
},
"field_labels": {
"additionalProperties": {
"maxLength": 120,
"type": "string"
},
"description": "Public labels/placeholders for form fields in the page's target language.",
"type": "object"
},
"fields": {
"items": {
"enum": [
"name",
"email",
"phone",
"message",
"company"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"mode": {
"enum": [
"contact",
"newsletter",
"booking_interest"
],
"type": "string"
},
"submit_label": {
"maxLength": 120,
"type": "string"
},
"success_message": {
"maxLength": 280,
"type": "string"
},
"title": {
"maxLength": 160,
"type": "string"
}
},
"required": [
"mode",
"fields"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a lead_form block.",
"enum": [
"lead_form"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Carousel or stack of testimonials.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"display": {
"enum": [
"carousel",
"stack"
],
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"author": {
"maxLength": 64,
"type": "string"
},
"avatar": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"body": {
"maxLength": 280,
"type": "string"
},
"rating": {
"maximum": 5,
"minimum": 1,
"type": "number"
},
"role": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"author",
"body"
],
"type": "object"
},
"maxItems": 12,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"type": {
"description": "Use this variant only for a reviews block.",
"enum": [
"reviews"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "QR + save-contact footer for digital business cards. The vCard is derived from the page header and contact blocks; props only carry presentation copy.",
"properties": {
"props": {
"additionalProperties": false,
"properties": {
"button_label": {
"description": "Save button text, e.g. \"Save contact\".",
"maxLength": 120,
"type": "string"
},
"style": {
"description": "qr_card renders a QR + caption footer; button renders a single save-contact button.",
"enum": [
"qr_card",
"button"
],
"type": "string"
},
"subtitle": {
"description": "Secondary caption, e.g. \"Adds my contact card\".",
"maxLength": 160,
"type": "string"
},
"title": {
"description": "Short caption, e.g. \"Scan to save\".",
"maxLength": 120,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a save_contact block.",
"enum": [
"save_contact"
],
"type": "string"
}
},
"required": [
"type",
"props"
],
"type": "object"
}
],
"type": "object"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId",
"block"
],
"type": "object"
},
"name": "block_add",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Delete one block by stable blockId. Use page_get first if unsure which id to remove. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"blockId": {
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId",
"blockId"
],
"type": "object"
},
"name": "block_delete",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Move a block to a new zero-based index in the page main slot. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"blockId": {
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"toIndex": {
"type": "number"
}
},
"required": [
"pageId",
"blockId",
"toIndex"
],
"type": "object"
},
"name": "block_reorder",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Patch one content block by stable blockId. Provide a props patch (merged into existing props) and/or a new type. Block types and props are validated against the strict per-type schema. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"description": "Patch one block. Choose the oneOf variant whose type matches the existing block, unless intentionally changing the block type.",
"oneOf": [
{
"additionalProperties": false,
"description": "Patch an existing block as link. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"highlight": {
"type": "boolean"
},
"icon": {
"maxLength": 64,
"type": "string"
},
"label": {
"maxLength": 120,
"type": "string"
},
"thumbnail": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"url": {
"description": "Destination URL using http, https, mailto, tel, or sms.",
"maxLength": 2048,
"type": "string"
},
"width": {
"description": "half lets two consecutive half-width links render side by side as one row. Default full.",
"enum": [
"full",
"half"
],
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a link block.",
"enum": [
"link"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as social_row. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 64,
"type": "string"
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"x",
"facebook",
"linkedin",
"spotify",
"apple_music",
"soundcloud",
"github",
"pinterest",
"threads",
"twitch",
"discord",
"telegram",
"snapchat",
"vimeo",
"behance",
"dribbble",
"medium",
"substack",
"website",
"other",
"email",
"phone",
"whatsapp"
],
"type": "string"
},
"url": {
"description": "For social platforms: a public http(s) profile URL. For contact platforms (email/phone/whatsapp): the bare email address or phone number — the page builds the mailto:/tel:/wa.me link.",
"type": "string"
}
},
"required": [
"platform",
"url"
],
"type": "object"
},
"maxItems": 16,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a social_row block.",
"enum": [
"social_row"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as whatsapp. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"label": {
"maxLength": 120,
"type": "string"
},
"message": {
"description": "Optional prefilled message.",
"maxLength": 500,
"type": "string"
},
"number": {
"description": "Public WhatsApp phone number.",
"maxLength": 32,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a whatsapp block.",
"enum": [
"whatsapp"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as phone_call. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"label": {
"maxLength": 120,
"type": "string"
},
"number": {
"description": "Public phone number.",
"maxLength": 32,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a phone_call block.",
"enum": [
"phone_call"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as email_contact. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"email": {
"description": "Public business email address.",
"type": "string"
},
"label": {
"maxLength": 120,
"type": "string"
},
"subject": {
"maxLength": 160,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a email_contact block.",
"enum": [
"email_contact"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as image. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"caption": {
"maxLength": 280,
"type": "string"
},
"image": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"layout": {
"enum": [
"classic",
"wide",
"background"
],
"type": "string"
},
"link_url": {
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a image block.",
"enum": [
"image"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as gallery. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"display": {
"enum": [
"grid",
"carousel"
],
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"maxItems": 24,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a gallery block.",
"enum": [
"gallery"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as video_embed. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"provider": {
"enum": [
"youtube",
"vimeo",
"mp4"
],
"type": "string"
},
"thumbnail": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"title": {
"maxLength": 160,
"type": "string"
},
"video_id": {
"description": "Video id or URL, depending on provider.",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a video_embed block.",
"enum": [
"video_embed"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as text. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"alignment": {
"enum": [
"left",
"center"
],
"type": "string"
},
"body": {
"maxLength": 2000,
"type": "string"
},
"heading": {
"maxLength": 160,
"type": "string"
},
"items": {
"items": {
"maxLength": 280,
"type": "string"
},
"maxItems": 12,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a text block.",
"enum": [
"text"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as map_embed. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"address": {
"description": "Public business address or service-area text.",
"maxLength": 400,
"type": "string"
},
"label": {
"maxLength": 160,
"type": "string"
},
"lat": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"lng": {
"maximum": 180,
"minimum": -180,
"type": "number"
},
"place_id": {
"maxLength": 160,
"type": "string"
},
"zoom": {
"maximum": 20,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a map_embed block.",
"enum": [
"map_embed"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as product_card. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"buy_url": {
"description": "Public http(s) purchase URL.",
"type": "string"
},
"cta_label": {
"maxLength": 120,
"type": "string"
},
"description": {
"maxLength": 280,
"type": "string"
},
"image": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"name": {
"maxLength": 160,
"type": "string"
},
"price_text": {
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a product_card block.",
"enum": [
"product_card"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as lead_form. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"consent_text": {
"maxLength": 400,
"type": "string"
},
"description": {
"maxLength": 280,
"type": "string"
},
"destination_email": {
"description": "Public/business lead recipient email.",
"type": "string"
},
"destination_webhook": {
"description": "Public http(s) webhook URL.",
"type": "string"
},
"field_labels": {
"additionalProperties": {
"maxLength": 120,
"type": "string"
},
"description": "Public labels/placeholders for form fields in the page's target language.",
"type": "object"
},
"fields": {
"items": {
"enum": [
"name",
"email",
"phone",
"message",
"company"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"mode": {
"enum": [
"contact",
"newsletter",
"booking_interest"
],
"type": "string"
},
"submit_label": {
"maxLength": 120,
"type": "string"
},
"success_message": {
"maxLength": 280,
"type": "string"
},
"title": {
"maxLength": 160,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a lead_form block.",
"enum": [
"lead_form"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as reviews. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"display": {
"enum": [
"carousel",
"stack"
],
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"author": {
"maxLength": 64,
"type": "string"
},
"avatar": {
"additionalProperties": false,
"properties": {
"alt": {
"description": "Alt text for accessibility.",
"type": "string"
},
"height": {
"type": "number"
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"src": {
"description": "Image URL or stored media URL.",
"type": "string"
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"width": {
"type": "number"
}
},
"required": [
"src"
],
"type": "object"
},
"body": {
"maxLength": 280,
"type": "string"
},
"rating": {
"maximum": 5,
"minimum": 1,
"type": "number"
},
"role": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"author",
"body"
],
"type": "object"
},
"maxItems": 12,
"type": "array"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a reviews block.",
"enum": [
"reviews"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Patch an existing block as save_contact. Provide the block's current type unless intentionally changing it.",
"properties": {
"blockId": {
"description": "The block id returned by block_add or page_get. Stable across reorders.",
"type": "string"
},
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"props": {
"additionalProperties": false,
"description": "Partial props patch for this block type. Include only fields you want to change.",
"properties": {
"button_label": {
"description": "Save button text, e.g. \"Save contact\".",
"maxLength": 120,
"type": "string"
},
"style": {
"description": "qr_card renders a QR + caption footer; button renders a single save-contact button.",
"enum": [
"qr_card",
"button"
],
"type": "string"
},
"subtitle": {
"description": "Secondary caption, e.g. \"Adds my contact card\".",
"maxLength": 160,
"type": "string"
},
"title": {
"description": "Short caption, e.g. \"Scan to save\".",
"maxLength": 120,
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "Use this variant only for a save_contact block.",
"enum": [
"save_contact"
],
"type": "string"
}
},
"required": [
"pageId",
"blockId",
"type",
"props"
],
"type": "object"
}
],
"type": "object"
},
"name": "block_update",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "List supported page layouts. Currently ships link_in_bio only.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "layouts_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Attach a ready media asset to the page. placement determines where: avatar (header), block_image (image inside a specific block — requires blockId), gallery_item (appended to a gallery — optional blockId targets a specific gallery; otherwise the first one is used), background (theme background).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"altText": {
"description": "Meaningful alt text for the image.",
"type": "string"
},
"blockId": {
"description": "Required when placement is block_image; optional for gallery_item (targets a specific gallery block).",
"type": "string"
},
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"mediaAssetId": {
"description": "The mediaAssetId returned by media_upload or media_upload_link_create.",
"format": "uuid",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
},
"placement": {
"description": "Where the image should be used. header_photo = business-card top photo, avatar = profile header avatar, block_image = image inside a block (requires blockId), gallery_item = appended to a gallery block, background = page background.",
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
}
},
"required": [
"pageId",
"mediaAssetId",
"placement"
],
"type": "object"
},
"name": "media_attach",
"outputSchema": {
"additionalProperties": true,
"properties": {
"altText": {
"type": "string"
},
"attached": {
"type": "boolean"
},
"content": {
"additionalProperties": true,
"type": "object"
},
"deletedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"nextStep": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"placement": {
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
},
"revisionId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"revisionVersion": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"awaiting_upload",
"processing",
"ready",
"failed",
"deleted"
],
"type": "string"
},
"uploadPageUrl": {
"type": "string"
},
"uploadedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
"required": [
"ok",
"mediaAssetId",
"status",
"placement",
"altText"
],
"type": "object"
}
},
{
"description": "Soft-delete a media asset and remove all references to it from the page content.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"mediaAssetId": {
"description": "The mediaAssetId to delete.",
"format": "uuid",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId",
"mediaAssetId"
],
"type": "object"
},
"name": "media_delete",
"outputSchema": {
"additionalProperties": true,
"properties": {
"altText": {
"type": "string"
},
"attached": {
"type": "boolean"
},
"content": {
"additionalProperties": true,
"type": "object"
},
"deletedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"nextStep": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"placement": {
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
},
"revisionId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"revisionVersion": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"awaiting_upload",
"processing",
"ready",
"failed",
"deleted"
],
"type": "string"
},
"uploadPageUrl": {
"type": "string"
},
"uploadedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
"required": [
"ok",
"mediaAssetId",
"status",
"placement",
"altText"
],
"type": "object"
}
},
{
"description": "Add an image to a page. PREFERRED for any image already on the web: pass its imageUrl and the server fetches it directly (no size limit, no attachment needed in chat). imageBase64 is ONLY for very small inline images — large base64 payloads are rejected by request-size limits and waste context, so never paste a photo's bytes; for a file on the user's device use media_upload_link_create instead. After a successful upload, call media_attach to place it (unless this returned content already showing it).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"altText": {
"description": "Meaningful alt text for the image.",
"type": "string"
},
"contentType": {
"description": "Declared MIME type, such as image/png. The server still verifies magic bytes.",
"type": "string"
},
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"fileName": {
"description": "Original file name when known.",
"type": "string"
},
"imageBase64": {
"description": "Base64 image bytes or a data:image/*;base64 data URI. Use only for small images.",
"type": "string"
},
"imageUrl": {
"description": "Public direct image URL. The server validates redirects and blocks private network targets.",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
},
"placement": {
"description": "Where the image should be used. header_photo = business-card top photo, avatar = profile header avatar, block_image = image inside a block (requires blockId), gallery_item = appended to a gallery block, background = page background.",
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "media_upload",
"outputSchema": {
"additionalProperties": true,
"properties": {
"altText": {
"type": "string"
},
"attached": {
"type": "boolean"
},
"content": {
"additionalProperties": true,
"type": "object"
},
"deletedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"nextStep": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"placement": {
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
},
"revisionId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"revisionVersion": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"awaiting_upload",
"processing",
"ready",
"failed",
"deleted"
],
"type": "string"
},
"uploadPageUrl": {
"type": "string"
},
"uploadedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
"required": [
"ok",
"mediaAssetId",
"status",
"placement",
"altText"
],
"type": "object"
}
},
{
"description": "Get an upload link for a photo on the user's own device (phone/computer) — the right tool whenever the image is not already at a public URL. Pass pageId (+ editToken for demo pages) and the placement (e.g. header_photo). Then show the returned uploadPageUrl to the user as a clickable link and ask them to open it and pick their photo: the page resizes the image for the web automatically and attaches it to the page, so you do NOT call media_attach afterward. The link expires (see expiresAt). After the user says they've uploaded, call page_get to confirm the photo is on the page.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"altText": {
"description": "Meaningful alt text for the image.",
"type": "string"
},
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
},
"placement": {
"description": "Where the image should be used. header_photo = business-card top photo, avatar = profile header avatar, block_image = image inside a block (requires blockId), gallery_item = appended to a gallery block, background = page background.",
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "media_upload_link_create",
"outputSchema": {
"additionalProperties": true,
"properties": {
"altText": {
"type": "string"
},
"attached": {
"type": "boolean"
},
"content": {
"additionalProperties": true,
"type": "object"
},
"deletedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"mediaAssetId": {
"format": "uuid",
"type": "string"
},
"nextStep": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"placement": {
"enum": [
"avatar",
"header_photo",
"block_image",
"gallery_item",
"background",
"unassigned"
],
"type": "string"
},
"revisionId": {
"format": "uuid",
"type": [
"string",
"null"
]
},
"revisionVersion": {
"type": [
"number",
"null"
]
},
"status": {
"enum": [
"awaiting_upload",
"processing",
"ready",
"failed",
"deleted"
],
"type": "string"
},
"uploadPageUrl": {
"type": "string"
},
"uploadedAt": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"variants": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
"required": [
"ok",
"mediaAssetId",
"status",
"placement",
"altText"
],
"type": "object"
}
},
{
"description": "Claim an anonymous demo page into an AUTHENTICATED account. This requires the signed-in user's OAuth — an anonymous chat/agent session cannot call it and will get an OAuth-required error. So in a normal agent conversation, do NOT call this to 'save' a demo page: instead share the claimUrl from the page_create/page_publish result with the user, who opens it, signs in, and keeps the page. Only call page_claim when the request already runs under the owner's OAuth.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"description": "The editToken returned by page_create for the anonymous demo page.",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId",
"editToken"
],
"type": "object"
},
"name": "page_claim",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Create a hosted link-in-bio page draft from a style preset. Provide title, displayName, and a preset (or 'auto' to infer from businessType/style). The page starts with empty placeholder blocks for you to fill in via block_update — do not invent content. This tool intentionally creates a draft only and does not return a publish action. After calling it, stop and show the preview URL. Do not call page_publish in the same turn unless the user's current message explicitly asks to publish, make the page live, or get a public share link. Anonymous demo pages expire unless claimed.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bio": {
"description": "Optional short bio for the header.",
"maxLength": 280,
"type": "string"
},
"businessType": {
"description": "Used by preset:auto inference. Examples: musician, restaurant, designer.",
"type": "string"
},
"displayName": {
"description": "Visible header display name. Defaults to title.",
"type": "string"
},
"initialPrompt": {
"maxLength": 12000,
"type": "string"
},
"layout": {
"description": "Layout id. Defaults to 'link_in_bio'.",
"enum": [
"link_in_bio"
],
"type": "string"
},
"preset": {
"description": "Style preset id, or 'auto' to infer deterministically from businessType/style.",
"enum": [
"classic_dark",
"sunset_gradient",
"editorial_serif",
"minimalist_light",
"local_business",
"bold_pop",
"zen_neutral",
"midnight_blue",
"card_warm_terracotta",
"card_navy_serif",
"card_editorial_dark",
"card_bold_realestate",
"auto"
],
"type": "string"
},
"slug": {
"description": "Preferred public URL slug.",
"type": "string"
},
"style": {
"description": "Free-form style hint used by preset:auto inference.",
"type": "string"
},
"title": {
"description": "Internal page title and default header display_name.",
"type": "string"
}
},
"required": [
"title",
"preset"
],
"type": "object"
},
"name": "page_create",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Create a hosted landing page draft from a structured brief. Accepts business name, category, layout, palette, primary action, explicit final-audience publicSections, and optional hero image. Planning fields such as audience, offer, primaryGoal, location, businessType, style, and mustInclude are context only and are not rendered as public body copy. Draft previews are customer-facing: do not pass owner instructions, section-planning labels, or placeholder copy as public content. Keep sparse briefs sparse: use only facts supplied by the user or imported public sources, plus light wording polish; do not invent menus, services, hours, facilities, locations, testimonials, guarantees, staff details, prices, or operational claims. Prefer one short section or no extra section when the prompt is minimal. If a requested CTA lacks its real destination, ask for it before creation or provide fallbackLeadForm with public copy. Returns a preview URL, edit token, and next-step hints. This tool intentionally creates a draft only and does not return a publish action. After calling it, stop and show the preview URL. Do not call page_publish in the same turn unless the user's current message explicitly asks to publish, make the page live, or get a public share link. Anonymous pages expire unless claimed via page_claim. For a vague or first-page request, prefer running page_onboarding_start first (or at least pass onboardingMainCategory) so the page starts from the right template. The draft seeds the chosen preset's starter blocks (empty placeholder links, social row, save-contact) for you to fill in — they never block publishing and are pruned if left empty. Then guide the user the way a builder would: use the returned previewUrl directly (you do not need page_preview), and work through the returned nextSteps (add a real bio, a photo via media_upload, social links) before offering to publish.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"audience": {
"description": "Planning context only. Not rendered directly as public page copy.",
"type": "string"
},
"bio": {
"description": "Optional short bio for the header.",
"maxLength": 280,
"type": "string"
},
"businessName": {
"type": "string"
},
"businessType": {
"description": "Planning context only. Not rendered directly as public page copy.",
"type": "string"
},
"fallbackLeadForm": {
"additionalProperties": false,
"description": "Public fallback contact/interest form to use when the requested primary action lacks a real destination. All copy must be final-audience copy in the page's target language.",
"properties": {
"consentText": {
"maxLength": 400,
"type": "string"
},
"description": {
"maxLength": 280,
"type": "string"
},
"fieldLabels": {
"additionalProperties": {
"maxLength": 120,
"type": "string"
},
"description": "Field labels/placeholders, for example name/email/message in the page's target language.",
"type": "object"
},
"fields": {
"items": {
"enum": [
"name",
"email",
"phone",
"message",
"company"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"mode": {
"enum": [
"contact",
"booking_interest"
],
"type": "string"
},
"submitLabel": {
"maxLength": 120,
"type": "string"
},
"successMessage": {
"maxLength": 280,
"type": "string"
},
"title": {
"maxLength": 160,
"type": "string"
}
},
"required": [
"title",
"submitLabel"
],
"type": "object"
},
"heroImageUrl": {
"description": "Explicit user-provided image URL for featured-photo or full-image styles.",
"type": "string"
},
"initialPrompt": {
"maxLength": 12000,
"type": "string"
},
"layout": {
"description": "Defaults to 'link_in_bio'.",
"enum": [
"link_in_bio"
],
"type": "string"
},
"locale": {
"type": "string"
},
"location": {
"description": "Public business address or service area intended for map/address actions, not direct body copy and not the user's private/current location.",
"type": "string"
},
"mustInclude": {
"description": "Planning checklist only. Do not put section names, CTA labels, owner instructions, or private notes here; not rendered directly.",
"items": {
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"offer": {
"description": "Planning context only. Not rendered directly as public page copy; use bio and publicSections for final-audience copy.",
"type": "string"
},
"onboardingLayout": {
"description": "Layout style: background_color (minimalist), full (featured photo), or background_image (full image background).",
"enum": [
"background_color",
"full",
"background_image"
],
"type": "string"
},
"onboardingMainCategory": {
"description": "Validated atom.bio category id from page_onboarding_*, for example physical-business or online-business.",
"type": "string"
},
"onboardingPalette": {
"description": "Palette id returned by page_onboarding_* paletteChoices, for example atom_dark_plum.",
"type": "string"
},
"onboardingSubCategory": {
"description": "Validated atom.bio subcategory id, for example health.",
"type": "string"
},
"preferredSlug": {
"description": "Desired URL path. Ask the user for it near the end of onboarding. Use normal letters, numbers, and hyphens; the server normalizes and makes it unique.",
"type": "string"
},
"preset": {
"description": "Style preset id, or 'auto' to infer deterministically. Defaults to 'auto'.",
"enum": [
"classic_dark",
"sunset_gradient",
"editorial_serif",
"minimalist_light",
"local_business",
"bold_pop",
"zen_neutral",
"midnight_blue",
"card_warm_terracotta",
"card_navy_serif",
"card_editorial_dark",
"card_bold_realestate",
"auto"
],
"type": "string"
},
"primaryActionId": {
"enum": [
"appointment",
"whatsapp",
"phone",
"maps",
"buy",
"lead",
"subscribe",
"follow"
],
"type": "string"
},
"primaryActionLabel": {
"description": "Public label for the primary action in the page's target language.",
"maxLength": 120,
"type": "string"
},
"primaryActionUrl": {
"description": "Real destination URL for the primary action when explicitly supplied by the user or imported public source, such as a booking link. Do not invent booking/order URLs; if missing, ask for it or use fallbackLeadForm.",
"type": "string"
},
"primaryGoal": {
"description": "Planning context only. Not rendered directly as public page copy.",
"type": "string"
},
"publicBusinessEmail": {
"description": "Public business contact email explicitly supplied by the user or a public source. Do not use the user's ChatGPT/account email.",
"type": "string"
},
"publicPhone": {
"description": "Public business phone number explicitly supplied by the user or a public source. Do not use the user's private/account phone.",
"type": "string"
},
"publicSections": {
"description": "Final-audience text sections to render on the public page. Write in the target language with correct spelling/accents. Only include facts the user supplied or that came from an imported public source; for sparse prompts, keep this short and avoid invented service lists, hours, benefits, testimonials, prices, or operational details.",
"items": {
"additionalProperties": false,
"description": "Final-audience page copy. Use the page's target language and correct spelling/accents. Do not put planning notes, owner instructions, or section labels here.",
"properties": {
"alignment": {
"enum": [
"left",
"center"
],
"type": "string"
},
"body": {
"maxLength": 2000,
"type": "string"
},
"heading": {
"maxLength": 160,
"type": "string"
},
"items": {
"items": {
"maxLength": 280,
"type": "string"
},
"maxItems": 12,
"type": "array"
}
},
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"publicWhatsapp": {
"description": "Public WhatsApp phone number explicitly supplied by the user or a public source. Do not use the user's account phone or invent placeholder numbers.",
"type": "string"
},
"sourceHandle": {
"type": "string"
},
"sourceUrl": {
"description": "Provenance reference only.",
"type": "string"
},
"style": {
"description": "Planning context only. Not rendered directly as public page copy.",
"type": "string"
}
},
"required": [
"businessName"
],
"type": "object"
},
"name": "page_create_from_brief",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Read a landing page draft, including its latest content JSON. For anonymous demo pages, include the editToken.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_get",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Update the link-in-bio page header: displayName, bio, verified checkmark, QR display, business-card display style (\"photo_hero\" large top photo or \"avatar\"), a short role label (e.g. \"Barber · Madrid\"), labelPosition, and the header photo (photoUrl; null removes it). Use only the fields you want to change. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bio": {
"anyOf": [
{
"maxLength": 280,
"type": "string"
},
{
"type": "null"
}
],
"description": "Short bio under the display name. Pass null to clear it."
},
"display": {
"anyOf": [
{
"enum": [
"avatar",
"photo_hero"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Header style: photo_hero = large business-card top photo, avatar = small round profile photo. Pass null to clear it."
},
"displayName": {
"description": "Visible display name in the page header.",
"maxLength": 80,
"type": "string"
},
"editToken": {
"type": "string"
},
"label": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"description": "Short role line near the name, e.g. \"Brand Designer · Austin, TX\". Pass null to clear it."
},
"labelPosition": {
"anyOf": [
{
"enum": [
"above_name",
"below_name"
],
"type": "string"
},
{
"type": "null"
}
]
},
"pageId": {
"format": "uuid",
"type": "string"
},
"photoAlt": {
"description": "Alt text for the header photo.",
"maxLength": 160,
"type": "string"
},
"photoObjectPosition": {
"description": "CSS focal point for the photo_hero crop, e.g. \"50% 28%\".",
"type": "string"
},
"photoUrl": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"description": "Header photo URL. Pass null to remove the current photo."
},
"showQr": {
"description": "Show a QR code for this page.",
"type": "boolean"
},
"verified": {
"description": "Show a verified checkmark next to the display name.",
"type": "boolean"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_header_update",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "RECOMMENDED first step for building a page. Returns the few questions worth asking (business name, primary visitor action, key content, optional source link) so you can then call page_create_from_brief. This is the simplest, most reliable path — prefer it. (page_onboarding_* offers extra category/layout/palette pickers but is a stateless planning helper, not required.) Call once per creation request; skip if the user already gave you a source URL. Does not create a page.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"businessName": {
"description": "Only include if the user already provided the business or project name.",
"type": "string"
},
"businessType": {
"description": "Business category inferred from the user's words, such as hamburger restaurant or dental clinic.",
"type": "string"
},
"locale": {
"description": "Preferred content locale if obvious from the conversation.",
"type": "string"
},
"originalRequest": {
"description": "The user's original page-creation request, copied verbatim when available.",
"maxLength": 12000,
"type": "string"
},
"primaryGoal": {
"description": "The main visitor action if known, such as book, call, WhatsApp, buy, or leave a lead.",
"type": "string"
},
"sourceHandle": {
"description": "Public social handle provided by the user.",
"type": "string"
},
"sourceUrl": {
"description": "Public HTTP/HTTPS source URL provided by the user, such as a business website or link-in-bio page. Protected platforms (social networks, maps, paywalls) require client-side browsing or pasted details instead.",
"type": "string"
}
},
"type": "object"
},
"name": "page_intake_start",
"outputSchema": {
"additionalProperties": false,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"enum": [
"provide_source",
"answer_questions",
"use_placeholders",
"create_from_brief"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"recommendedTool": {
"type": "string"
}
},
"required": [
"id",
"label",
"prompt"
],
"type": "object"
},
"type": "array"
},
"canCreateNow": {
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"mode": {
"enum": [
"intake"
],
"type": "string"
},
"ok": {
"type": "boolean"
},
"promptToUser": {
"type": "string"
},
"questions": {
"items": {
"type": "string"
},
"type": "array"
},
"recommendedNextTool": {
"type": "string"
},
"sourceGuidance": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"mode",
"title",
"promptToUser",
"canCreateNow",
"recommendedNextTool",
"missingFields",
"questions",
"sourceGuidance",
"actions"
],
"type": "object"
}
},
{
"description": "Update internal page title, URL slug, and SEO title/description. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"seoDescription": {
"description": "SEO meta description value.",
"type": "string"
},
"seoTitle": {
"description": "SEO <title> tag value.",
"type": "string"
},
"slug": {
"description": "Preferred public URL slug.",
"type": "string"
},
"title": {
"description": "Internal page title shown in editor results.",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_meta_update",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Optional planning helper that returns category/layout/palette/primary-action choices and a quality checklist (it does NOT create a page). Use it only if you want those pickers; otherwise page_intake_start → page_create_from_brief is the simpler path. IMPORTANT: this flow is STATELESS — page_onboarding_update does not remember earlier calls, so each update must resend the FULL set of selections + knownFields gathered so far. As soon as you have a business name and a primary action, stop and call page_create_from_brief (you do not need to reach a 'ready' step).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"locale": {
"description": "Preferred UI locale, such as es or en.",
"type": "string"
},
"originalRequest": {
"maxLength": 12000,
"type": "string"
},
"suggestedSelection": {
"additionalProperties": false,
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"mainCategory": {
"description": "Normalized id from the AI client, for example physical-business or online-business. The app does not infer this from raw text.",
"type": "string"
},
"source": {
"enum": [
"user_agent_inference",
"user_selected",
"imported_source"
],
"type": "string"
},
"subCategory": {
"description": "Normalized subcategory id valid for the selected mainCategory, for example health.",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"name": "page_onboarding_start",
"outputSchema": {
"additionalProperties": false,
"properties": {
"canContinue": {
"type": "boolean"
},
"choices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"createFromBriefHints": {
"additionalProperties": true,
"type": "object"
},
"imageGuidance": {
"additionalProperties": true,
"type": "object"
},
"invalidSelection": {
"items": {
"type": "string"
},
"type": "array"
},
"layoutChoices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"layoutGuidance": {
"additionalProperties": true,
"type": "object"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"mode": {
"enum": [
"onboarding"
],
"type": "string"
},
"nextPrompt": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"paletteChoices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"primaryActions": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"profileCopy": {
"additionalProperties": true,
"type": "object"
},
"qualityChecklist": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"readyToCreate": {
"type": "boolean"
},
"recommendedBlocks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"recommendedLinks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"recommendedMissingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"selected": {
"additionalProperties": true,
"type": "object"
},
"slugGuidance": {
"additionalProperties": true,
"type": "object"
},
"stepId": {
"type": "string"
},
"uiHtml": {
"type": "string"
}
},
"required": [
"ok",
"mode",
"stepId",
"canContinue",
"selected",
"invalidSelection",
"missingFields",
"choices",
"layoutChoices",
"paletteChoices",
"primaryActions",
"recommendedLinks",
"recommendedBlocks",
"profileCopy",
"slugGuidance",
"qualityChecklist",
"recommendedMissingFields",
"layoutGuidance",
"imageGuidance",
"readyToCreate",
"uiHtml",
"nextPrompt",
"createFromBriefHints"
],
"type": "object"
}
},
{
"description": "Validate onboarding selections and return the remaining checklist. STATELESS: it does not remember previous calls, so every call must include the FULL accumulated selection (mainCategory, subCategory, layout, palette, primaryAction) plus all knownFields (name, description, action destination, etc.) gathered so far — not just the latest answer, or earlier choices will look 'missing'. You do not need to loop to a 'ready' state: once you have a name and a primary action, call page_create_from_brief with those values.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"knownFields": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"hasImage": {
"type": "boolean"
},
"name": {
"type": "string"
},
"primaryActionDestination": {
"description": "A real destination explicitly supplied by the user or imported public source. Do not invent booking/order URLs.",
"type": "string"
},
"supportingContent": {
"description": "True when the user has provided enough extra page content, such as services, products, location, hours, FAQs, reviews, or key notes.",
"type": "boolean"
},
"supportingLinks": {
"description": "True when the user has provided the initial phone/WhatsApp/location/social/site links they want on the page.",
"type": "boolean"
}
},
"type": "object"
},
"locale": {
"type": "string"
},
"selection": {
"additionalProperties": false,
"properties": {
"desiredPath": {
"description": "User's desired URL path. The server normalizes to letters, numbers, and hyphens.",
"type": "string"
},
"layout": {
"enum": [
"background_color",
"full",
"background_image"
],
"type": "string"
},
"mainCategory": {
"type": "string"
},
"palette": {
"description": "Palette id returned by paletteChoices, for example atom_dark_plum or atom_black.",
"type": "string"
},
"primaryAction": {
"enum": [
"appointment",
"whatsapp",
"phone",
"maps",
"buy",
"lead",
"subscribe",
"follow"
],
"type": "string"
},
"recommendedBlock": {
"enum": [
"image",
"product",
"contact_form",
"text"
],
"type": "string"
},
"subCategory": {
"type": "string"
}
},
"type": "object"
},
"stepId": {
"enum": [
"category",
"layout",
"profile",
"primary-action",
"ready"
],
"type": "string"
}
},
"type": "object"
},
"name": "page_onboarding_update",
"outputSchema": {
"additionalProperties": false,
"properties": {
"canContinue": {
"type": "boolean"
},
"choices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"createFromBriefHints": {
"additionalProperties": true,
"type": "object"
},
"imageGuidance": {
"additionalProperties": true,
"type": "object"
},
"invalidSelection": {
"items": {
"type": "string"
},
"type": "array"
},
"layoutChoices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"layoutGuidance": {
"additionalProperties": true,
"type": "object"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"mode": {
"enum": [
"onboarding"
],
"type": "string"
},
"nextPrompt": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"paletteChoices": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"primaryActions": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"profileCopy": {
"additionalProperties": true,
"type": "object"
},
"qualityChecklist": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"readyToCreate": {
"type": "boolean"
},
"recommendedBlocks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"recommendedLinks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"recommendedMissingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"selected": {
"additionalProperties": true,
"type": "object"
},
"slugGuidance": {
"additionalProperties": true,
"type": "object"
},
"stepId": {
"type": "string"
},
"uiHtml": {
"type": "string"
}
},
"required": [
"ok",
"mode",
"stepId",
"canContinue",
"selected",
"invalidSelection",
"missingFields",
"choices",
"layoutChoices",
"paletteChoices",
"primaryActions",
"recommendedLinks",
"recommendedBlocks",
"profileCopy",
"slugGuidance",
"qualityChecklist",
"recommendedMissingFields",
"layoutGuidance",
"imageGuidance",
"readyToCreate",
"uiHtml",
"nextPrompt",
"createFromBriefHints"
],
"type": "object"
}
},
{
"description": "Return the current preview URL for a page. You usually do not need this: page_create and page_create_from_brief already return a ready-to-open previewUrl. For an anonymous demo page you must pass the editToken from the create result; calling this with pageId alone fails.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_preview",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Publish the latest page revision. Call this only when the user's latest message explicitly asks to publish, make the page live, or get a public share link. Do not call this immediately after page_create or page_create_from_brief just because the draft is publish-ready. For anonymous demo pages, include the editToken returned by page_create. The response includes nextSteps: always share these with the user after publishing — they include the claim reminder and any remaining improvements.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"description": "Required for anonymous demo pages. Use the editToken returned by page_create.",
"type": "string"
},
"pageId": {
"description": "The pageId returned by page_create.",
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_publish",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Apply a partial theme patch. Theme fields are enum-constrained (button variant/radius/shadow, font family/weight, density, icon_size). Use presets_list first if the user wants a complete restyle. For already-published pages, this saves an unpublished latest revision only. Do not call page_publish in the same assistant turn after this edit. Stop and tell the user the draft/preview was updated, then wait for a separate user message that explicitly asks to update the live link, publish, or make the changes public before calling page_publish. Do NOT call page_unpublish either — the live page should stay public; only unpublish when the user explicitly asks to take it down.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"theme": {
"additionalProperties": false,
"description": "Partial theme patch. Provide only fields you want to change.",
"properties": {
"accent_color": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"background": {
"description": "Page background. If supplied, include the background type and its required fields.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"color": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"filter": {
"enum": [
"none",
"blur",
"dim"
],
"type": "string"
},
"type": {
"enum": [
"solid"
],
"type": "string"
}
},
"required": [
"type",
"color"
],
"title": "solid",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"maximum": 360,
"minimum": 0,
"type": "number"
},
"filter": {
"enum": [
"none",
"blur",
"dim"
],
"type": "string"
},
"from": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"to": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"type": {
"enum": [
"gradient"
],
"type": "string"
}
},
"required": [
"type",
"from",
"to"
],
"title": "gradient",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"filter": {
"enum": [
"none",
"blur",
"dim"
],
"type": "string"
},
"overlay": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"src": {
"description": "Background image URL.",
"type": "string"
},
"type": {
"enum": [
"image"
],
"type": "string"
}
},
"required": [
"type",
"src"
],
"title": "image",
"type": "object"
}
]
},
"button": {
"additionalProperties": false,
"description": "Button style. When supplied, include variant, radius, and shadow.",
"properties": {
"radius": {
"enum": [
"sharp",
"soft",
"pill"
],
"type": "string"
},
"shadow": {
"enum": [
"none",
"soft",
"hard",
"lift"
],
"type": "string"
},
"variant": {
"enum": [
"solid",
"outline",
"soft",
"surface"
],
"type": "string"
}
},
"required": [
"variant",
"radius",
"shadow"
],
"type": "object"
},
"density": {
"enum": [
"compact",
"comfortable",
"roomy"
],
"type": "string"
},
"font": {
"additionalProperties": false,
"description": "Font style. When supplied, include family and weight.",
"properties": {
"family": {
"enum": [
"inter",
"geist",
"fraunces",
"space-grotesk",
"karla",
"bricolage-grotesque",
"newsreader",
"instrument-serif",
"archivo",
"hanken-grotesk"
],
"type": "string"
},
"heading_family": {
"description": "Optional display font for the page name/headings, paired with family as the body font.",
"enum": [
"inter",
"geist",
"fraunces",
"space-grotesk",
"karla",
"bricolage-grotesque",
"newsreader",
"instrument-serif",
"archivo",
"hanken-grotesk"
],
"type": "string"
},
"heading_weight": {
"description": "Heading weight. Defaults to bold.",
"enum": [
"regular",
"medium",
"bold"
],
"type": "string"
},
"weight": {
"enum": [
"regular",
"medium",
"bold"
],
"type": "string"
}
},
"required": [
"family",
"weight"
],
"type": "object"
},
"icon_size": {
"enum": [
"sm",
"md",
"lg"
],
"type": "string"
},
"muted_text_color": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
},
"text_color": {
"description": "CSS color: hex, rgb()/rgba(), hsl()/hsla(), or named color.",
"type": "string"
}
},
"type": "object"
}
},
"required": [
"pageId",
"theme"
],
"type": "object"
},
"name": "page_theme_update",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "Remove a published landing page from public availability while keeping its draft and revision history.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"editToken": {
"type": "string"
},
"pageId": {
"format": "uuid",
"type": "string"
}
},
"required": [
"pageId"
],
"type": "object"
},
"name": "page_unpublish",
"outputSchema": {
"additionalProperties": true,
"properties": {
"actions": {
"items": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"type": "object"
},
"id": {
"enum": [
"preview",
"publish",
"keep_editing",
"claim"
],
"type": "string"
},
"label": {
"type": "string"
},
"prompt": {
"type": "string"
},
"tool": {
"type": "string"
},
"type": {
"enum": [
"link",
"tool",
"chat"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"type",
"label"
],
"type": "object"
},
"type": "array"
},
"canPublish": {
"type": "boolean"
},
"claimUrl": {
"type": [
"string",
"null"
]
},
"content": {
"additionalProperties": true,
"type": "object"
},
"editToken": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"isClaimed": {
"type": "boolean"
},
"isPublished": {
"type": "boolean"
},
"liveUpdateMessage": {
"description": "Plain-language instruction explaining that an edit to an already-published page is draft-only and must not be published until a later explicit user request.",
"type": [
"string",
"null"
]
},
"liveUpdateRequired": {
"description": "True after an edit to an already-published page when the public live page still needs page_publish to reflect the latest revision.",
"type": "boolean"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"nextSteps": {
"description": "Enrichment hints to present to the user. Address 'required' items before publishing.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"priority": {
"enum": [
"required",
"recommended",
"optional"
],
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"id",
"priority",
"message"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"pageId": {
"format": "uuid",
"type": "string"
},
"previewUrl": {
"type": "string"
},
"publishPolicy": {
"description": "For edit tools on already-published pages, this is wait_for_separate_user_request to prevent same-turn publishing.",
"type": [
"string",
"null"
]
},
"publishedUrl": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"status": {
"enum": [
"draft",
"published"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"ok",
"pageId",
"slug",
"title",
"status",
"isPublished",
"previewUrl",
"publishedUrl",
"claimUrl",
"editToken",
"expiresAt",
"isClaimed",
"canPublish",
"actions"
],
"type": "object"
}
},
{
"description": "List the 8 curated style presets (theme + starter blocks) for link-in-bio. Use to offer the user a choice or to confirm a preset:auto selection.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "presets_list",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Fetch a public website URL and extract a structured brief with business name, description, contact links, and suggested page blocks. Only works with public HTTP/HTTPS pages. Does not bypass login, CAPTCHA, or paywalls. Returns extracted fields and suggestedBlocks for use with page_create_from_brief.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"locale": {
"description": "Preferred output locale if obvious from the conversation, such as es or en.",
"type": "string"
},
"sourceUrl": {
"description": "Public http/https source URL to import.",
"format": "uri",
"type": "string"
}
},
"required": [
"sourceUrl"
],
"type": "object"
},
"name": "source_import",
"outputSchema": {
"additionalProperties": false,
"properties": {
"brief": {
"additionalProperties": false,
"properties": {
"audience": {
"type": "string"
},
"businessName": {
"type": "string"
},
"locale": {
"type": "string"
},
"location": {
"type": "string"
},
"mustInclude": {
"items": {
"type": "string"
},
"type": "array"
},
"offer": {
"type": "string"
},
"primaryGoal": {
"type": "string"
},
"publicBusinessEmail": {
"type": "string"
},
"publicPhone": {
"type": "string"
},
"publicWhatsapp": {
"type": "string"
},
"sourceUrl": {
"type": "string"
}
},
"required": [
"businessName",
"sourceUrl"
],
"type": "object"
},
"confidence": {
"type": "number"
},
"extracted": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"emails": {
"items": {
"type": "string"
},
"type": "array"
},
"images": {
"items": {
"additionalProperties": false,
"properties": {
"alt": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"text": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url"
],
"type": "object"
},
"type": "array"
},
"phones": {
"items": {
"type": "string"
},
"type": "array"
},
"siteName": {
"type": "string"
},
"structuredTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"whatsapp": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"structuredTypes",
"links",
"images",
"emails",
"phones",
"whatsapp"
],
"type": "object"
},
"fetchMode": {
"enum": [
"public_http",
"public_http_browser_compatible"
],
"type": "string"
},
"finalUrl": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"sourceUrl": {
"type": "string"
},
"suggested_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"props": {
"additionalProperties": true,
"type": "object"
},
"source": {
"type": "string"
},
"type": {
"enum": [
"link",
"social_row",
"whatsapp",
"phone_call",
"email_contact",
"image",
"gallery",
"video_embed",
"text",
"map_embed",
"product_card",
"lead_form",
"reviews",
"save_contact"
],
"type": "string"
}
},
"required": [
"id",
"type",
"props",
"source"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"sourceUrl",
"finalUrl",
"fetchMode",
"confidence",
"warnings",
"brief",
"extracted",
"suggested_blocks"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7a04ec517d637223c070b8b6153328f872f7037f0c66b6811dea3c40bda71cb6 | sha256sum