MCP Tool Reference

Tools for creating, updating, listing, and managing websites.

list_websites — List all websites owned by the authenticated user. No parameters required.

create_website — Create a new website with AI-generated content via interactive questionnaire.
Required (Mode 2): website_name (string), category (string), headline, subheading, about_title, about_description
Optional: goal, audience, offerings (array), services, features, products, testimonials, faq, menus, palette ("Bright"/"Pastel"/"Dark"), meta_title, meta_description, gallery_description, address

create_website_from_template — Create a website by cloning an existing template.
Required: template_id (string — site ID of the template from list_templates)
Optional: site_name (string), theme_id (string — color theme override)

update_website — Update site-level settings including name, category, color palette, fonts, button styles, and more.
Required: site_id (string)
Optional: site_name, category, palette colors (c0c5), font, primary_button, secondary_button, link_button

delete_website — Permanently delete a website and all associated data.
Required: site_id (string)
Optional: confirm_site_name (string — exact name confirmation for safety)

get_website_status — Get website configuration and publish status.
Required: site_id (string)

publish_website — Publish the entire website to make it live.
Required: site_id (string)

check_publish_status — Check real-time publish status of a website or a single page. Use after calling publish_website or publish_page to monitor progress. Returns status (Running, Completed, Failed), whether the publish is stuck, batch progress, and any error messages.
Required: site_id (string)
Optional: page_id (string — to check single-page publish status)

Sample MCP Request:
{"jsonrpc": "2.0","id": 1,"method": "tools/call","params": {"name": "check_publish_status","arguments": {"site_id": "abc123"}}}
Sample Response:
{"status": "Completed","stuck": false,"batch_start": 1,"batch_size": 50}

duplicate_website — Create a copy of an existing website with all pages and images.
Required: site_id (string)

list_templates — List all available website templates with categories and preview URLs.
Optional: category (string), template_name (string), min_page_count (integer), limit (integer), offset (integer)

update_header — Update the site header/navigation globally across all pages.
Required: site_id (string)
Optional: layout (header_v1–header_v14), site_name, logo_url, logo_alt, sticky (boolean), shadow (boolean), links (array), buttons (array), background_color, banner settings

update_footer — Update the site footer globally across all pages.
Required: site_id (string)
Optional: layout (footer_v1–footer_v4), columns (array), social_links, copyright_text, background/spacing settings

remove_redirect — Remove a URL redirect rule from a website.
Required: site_id (string), source_url (string)

Website Management

Tools for creating, updating, listing, and managing websites.

list_websites — List all websites owned by the authenticated user. No parameters required.

create_website — Create a new website with AI-generated content via interactive questionnaire.
Required (Mode 2): website_name (string), category (string), headline, subheading, about_title, about_description
Optional: goal, audience, offerings (array), services, features, products, testimonials, faq, menus, palette ("Bright"/"Pastel"/"Dark"), meta_title, meta_description, gallery_description, address

create_website_from_template — Create a website by cloning an existing template.
Required: template_id (string — site ID of the template from list_templates)
Optional: site_name (string), theme_id (string — color theme override)

update_website — Update site-level settings including name, category, color palette, fonts, button styles, and more.
Required: site_id (string)
Optional: site_name, category, palette colors (c0c5), font, primary_button, secondary_button, link_button

delete_website — Permanently delete a website and all associated data.
Required: site_id (string)
Optional: confirm_site_name (string — exact name confirmation for safety)

get_website_status — Get website configuration and publish status.
Required: site_id (string)

publish_website — Publish the entire website to make it live.
Required: site_id (string)

duplicate_website — Create a copy of an existing website with all pages and images.
Required: site_id (string)

list_templates — List all available website templates with categories and preview URLs.
Optional: category (string), template_name (string), min_page_count (integer), limit (integer), offset (integer)

update_header — Update the site header/navigation globally across all pages.
Required: site_id (string)
Optional: layout (header_v1–header_v14), site_name, logo_url, logo_alt, sticky (boolean), shadow (boolean), links (array), buttons (array), background_color, banner settings

update_footer — Update the site footer globally across all pages.
Required: site_id (string)
Optional: layout (footer_v1–footer_v4), columns (array), social_links, copyright_text, background/spacing settings

remove_redirect — Remove a URL redirect rule from a website.
Required: site_id (string), source_url (string)

Page Management

Tools for adding, updating, deleting, and listing pages within a website.

list_pages — List all pages for a site with metadata, URLs, and publish status.
Required: site_id (string)

add_page — Create a new page on a site.
Required: site_id (string), page_name (string), page_url (string)
Optional: is_home_page (boolean), meta_title, meta_description, show_toc (boolean), generate_content (boolean), generate_social_image (boolean)

update_page — Update an existing page's metadata or settings.
Required: site_id (string), page_id (string)
Optional: page_name, page_url, is_home_page, meta_title, meta_description, show_toc, generate_social_image (boolean)

delete_page — Permanently delete a page from a site.
Required: site_id (string), page_id (string)
Optional: confirm_page_name (string)

duplicate_page — Clone an existing page with all its sections.
Required: site_id (string), page_id (string)

publish_page — Publish a specific page to make it live.
Required: site_id (string), page_id (string)

Section Management

Tools for managing sections within pages — adding, updating, deleting, duplicating, and reordering.

get_page_sections — Retrieve all sections of a page with their IDs, types, layouts, and content.
Required: site_id (string), page_id (string)

list_layouts — List available layouts for a given section type.
Optional: section_type (string)

add_section — Add a new section to a page.
Required: site_id (string), page_id (string), section_type (string), layout (string)
Optional: title, description, position (integer), generate_image (boolean), generate_gallery_images (boolean)

update_section — Update an existing section's content, layout, or styling.
Required: site_id (string), page_id (string), section_type (string)
Optional: section_index (number), title, description, layout, html_id, styling fields, background settings

delete_section — Permanently delete a section from a page.
Required: page_id (string)
Optional: site_id (string), section_id (string), section_type (string), confirm_section_id (string)

duplicate_section — Copy a section within the same page.
Required: site_id (string), page_id (string), section_index (number)

reorder_sections — Move a section to a new position on the page.
Required: site_id (string), page_id (string), from_index (integer), to_index (integer)

Item Management

Tools for managing repeatable items (cards) within sections — such as service cards, feature cards, product cards, and testimonials.

add_item — Add a new item/card to a section.
Required: site_id (string), page_id (string), section_type (string)
Optional: title, description, subtitle, image_url, image_alt, highlight (boolean), highlight_label, links (array), generate_content (boolean)

update_item — Update an existing item/card.
Required: page_id (string), section_type (string), item_index (number)
Optional: title, description, subtitle, image_url, image_alt, generate_image (boolean), highlight (boolean), highlight_label, links (array)

remove_item — Remove an item/card from a section.
Required: page_id (string), section_type (string), item_index (number)

FAQ Management

Tools for managing FAQ items within FAQ sections.

add_faq_item — Add a new FAQ question and answer to a FAQ section.
Required: page_id (string), question (string), answer (string)

update_faq_item — Update an existing FAQ item.
Required: page_id (string), item_index (number)
Optional: question (string), answer (string)

remove_faq_item — Remove a FAQ item from a section.
Required: page_id (string), item_index (number)

Table Management

Tools for managing table columns and rows within table sections.

add_table_column — Add a new column to a table section.
Required: site_id (string), page_id (string), section_id (string), header (string)

update_table_column — Update a table column header by index.
Required: site_id (string), page_id (string), section_id (string), column_index (number), header (string)

remove_table_column — Remove a table column by index.
Required: site_id (string), page_id (string), section_id (string), column_index (number)

add_table_row — Add a new row to a table section.
Required: site_id (string), page_id (string), section_id (string), cells (array of strings)

update_table_row — Update data in a table row by index.
Required: site_id (string), page_id (string), section_id (string), row_index (number)
Optional: cells (array — full row replacement), cell_index (number) + value (string) — for single cell update

remove_table_row — Remove a table row by index.
Required: site_id (string), page_id (string), section_id (string), row_index (number)

Blog Management

Tools for managing blog settings and blog posts.

update_blog_settings — Enable or disable the blog feature for a website.
Required: site_id (string), enabled (boolean)

create_blog_post — Create a new blog post as a draft (not published until you use publish_page).
Required: site_id (string), title (string)
Optional: content (HTML string), slug (string), meta_title, meta_description, featured_image (S3 URL string), generate_content (boolean — auto-generate content and SEO fields)

update_blog_post — Update an existing blog post. Only provided fields are changed.
Required: site_id (string), post_id (string)
Optional: title, content, slug, meta_title, meta_description, featured_image (S3 URL), regenerate_featured_image (boolean)

list_blog_posts — List all blog posts for a site with IDs, titles, slugs, and status.
Required: site_id (string)
Optional: published_only (boolean), limit (integer)

delete_blog_post — Permanently delete a blog post.
Required: site_id (string), post_id (string)

Domain Management

Tools for managing custom domains, SSL certificates, and primary domain settings.

list_custom_domains — List all custom domains attached to a site.
Required: site_id (string)

add_custom_domain — Attach a custom domain to a site.
Required: site_id (string), domain (string)

validate_custom_domain — Check DNS configuration for a custom domain.
Required: site_id (string), domain (string)

set_primary_domain — Set the primary domain for a site.
Required: site_id (string), domain (string)

delete_custom_domain — Remove a custom domain from a site.
Required: site_id (string), domain (string)

check_ssl_status — Check SSL certificate provisioning status for a domain.
Required: site_id (string), domain (string)

Image Management

Tools for uploading, listing, editing, and deleting images.

upload_image — Upload an image to a site's media library using base64-encoded data.
Required: site_id (string), file_name (string), mime_type (string — "image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml"), base64_data (string — base64-encoded image data without prefix)
Optional: thumbnail_width (integer — default 512)

list_images — List all images in a site's media library with URLs, sizes, and usage counts.
Required: site_id (string)
Optional: page_id (string — check usage on specific page)

delete_image — Delete an image if it is not used anywhere on the site.
Required: site_id (string), image_id (string)

edit_image — Edit an image: crop, rotate, flip, or zoom. Creates a new image; original is preserved.
Required: site_id (string), image_id (string)
Optional: crop_ratio ("1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "free"), rotate ("90", "180", "270"), flip_horizontal (boolean), flip_vertical (boolean), zoom (number, 1.0–5.0)

SEO

Tools for reading and updating SEO metadata at site and page level.

read_seo — Read current SEO settings. Site-level returns favicon, OG image, meta title/description. Page-level returns the page's meta title, description, and social image.
Required: site_id (string)
Optional: page_id (string — for page-level SEO)

update_seo — Update SEO settings at site level and/or page level.
Required: site_id (string)
Optional: page_id (string), meta_title (string), meta_description (string), favicon_base64 (string), favicon_file_name, favicon_mime_type, social_image_base64 (string), social_image_file_name, social_image_mime_type, social_media_image_alt, social_media_description

Custom Code

Tools for reading and updating custom HTML/CSS/JS code injected into the site.

read_custom_code — Read the current custom code snippets (head and body).
Required: site_id (string)

update_custom_code — Update custom code injected into the site's HTML.
Required: site_id (string)
Optional: head_code (string — injected into <head>, max 50KB), body_code (string — injected before </body>, max 50KB), mode ("append" or "replace" — default "append")

Theme & Styling

Tools for listing available color palettes, font pairings, and button styles.

list_color_palettes — List all available color palettes grouped by category (Bright, Pastel, Dark).
Optional: category ("Bright", "Pastel", or "Dark" — filter by category)

list_font_pairings — List all available font pairings showing heading and body font combinations.
No required parameters.

list_button_styles — List all available button style presets with border radius, padding, and styling options.
No required parameters.

Usage note: Use these tools when creating or updating a website to select theme options. Pass the returned IDs to create_website or update_website to apply a palette or font pairing.

Contributors

Tools for managing site contributors (collaborators with edit access).

invite_contributors — Invite one or more contributors by email address.
Required: site_id (string), emails (array of strings)

remove_contributor — Remove a contributor from a site by email.
Required: site_id (string), email (string)

list_contributors — List all contributors for a site with their email and role.
Required: site_id (string)

Billing & Subscriptions

Tools for managing plans, subscriptions, checkout sessions, and invoices.

list_plans — List all available subscription plans with pricing and features.
No required parameters.

get_subscriptions — Get active subscriptions for a site.
Required: site_id (string)

create_checkout_session — Create a Stripe checkout session for purchasing or upgrading a plan.
Required: site_id (string)
Optional: plan_id (string — Stripe price ID), plan_key (string — "pro" or "business"), interval ("monthly" or "yearly"), success_url, cancel_url

cancel_subscription — Cancel an active subscription at the end of the current billing period.
Required: site_id (string), subscription_id (string)

cancel_upcoming_subscription — Cancel a scheduled plan change without cancelling the active subscription.
Required: site_id (string), subscription_id (string)

resume_subscription — Resume a subscription that was set to cancel at period end.
Required: site_id (string), subscription_id (string)

list_invoices — List all Stripe invoices for a site with amount, status, and PDF URLs.
Required: site_id (string)
Optional: limit (integer)

Form Submissions

Tool for listing form submissions collected from contact forms on the site.

list_form_submissions — List all form submissions for a site grouped by month. Returns submitted form data including name, email, message, and submission timestamp.
Required: site_id (string)
Optional: year_month (string — "YYYY-MM" format to filter by month)