WebCake Storefront MCP

Get the affiliate commission programs (order-level and product-level) configured for the site.

Get aggregate affiliate statistics (clicks, orders, commission, payouts) for the site.

List products enrolled in the affiliate program (with their commission settings).

List affiliate-attributed orders (referrals that converted).

List affiliate accounts (registered affiliates / referrers).

List affiliate payout requests/records.

Create/update the order-level affiliate commission program. `payload` is the program object (e.g. { "is_activated": true, "commission_type": ..., "commission_value": ... }).

Create/update the product-level affiliate commission program. `payload` is the program object.

Enroll/update a product in the affiliate program with its own commission. `payload` includes the product id and commission fields (e.g. { "product_id": "...", "commission_type": ..., "commission_value": ... }).

Remove products from the affiliate program. `payload` typically { ids: [...] }.

Update the status of affiliate payout(s). `payload` typically { ids: [...], status: <code> }.

Remove affiliate accounts. `payload` typically { ids: [...] }.

Update an affiliate account (e.g. commission rate, status). `payload` is the account object incl. its id.

List booking calendars (services with availability rules) for the current site.

Create a booking calendar. `config_weekdays`/`config_days` describe availability windows. `appointment_classifies` links service classifies by id ([{ "id": "..." }]). `assignee_id` = employee, `appointment_address_id` = location.

Update a booking calendar. Pass `id` plus any fields to change (same shape as create).

Delete booking calendars by id.

Duplicate booking calendars by id (creates copies).

List booked appointments for the current site.

List appointment locations/addresses.

Create an appointment location. Region ids are optional (Vietnamese geo ids).

Update an appointment location. Pass `id` plus fields to change.

Delete appointment locations by id.

List appointment classifies (service categories/types).

Create an appointment classify (service type).

Update an appointment classify. Pass `id` plus fields to change.

Delete appointment classifies by id.

List appointment employees (people that appointments can be assigned to).

Create an appointment employee (assignee).

Update an appointment employee. Pass `id` plus fields to change.

Delete appointment employees by id.

Get the device-template groups for the Product Design app.

Create products from selected device-template groups (Product Design app).

List Personal Product Design assignments (products enabled for personalization).

Enable/update Personal Product Design for products (bulk).

Disable Personal Product Design for the given ids.

Get the per-variation print/design templates for a product (PPD app).

List courses (Course app).

Get a course by id (tracks, downloads, etc.).

Create a course linked to a product. `tracks` are lessons; `file_downloads` are attachments. Note: video tracks trigger async HLS processing. A product can only link to one course.

Update a course by id (partial). Pass `id` plus fields to change.

Delete a course by id (also deletes its tracks).

Delete multiple courses by id.

List members (enrolled customers) of a course.

Uninstall (remove) an installed application from the current site. Pass the app's subscription id — get it from list_apps (the `id` field) or get_app.

Update an installed app's configuration. Pass the app subscription id and an `attrs` object that is merged onto the subscription — usually `{ settings: {...} }`, optionally `{ status }`. For the product-review app, prefer update_app_review (it also propagates shop_info).

Update the product-review app's settings (e.g. shop_info, auto-approve, display options). Pass the review app's subscription id (get_app with type "product_review") and the full `settings` object.

List blog articles (metadata only, without HTML content). Use get_article to get full content

Get article details by ID

Create a blog article so blog/post pages (post-list, grid-blog, post-overlay) have content. Built via the dashboard command pipeline: title + optional summary, HTML content, image URLs, and category linkage. Pass category_ids from create_blog_category / list articles' categories so the post shows up…

Update a blog article

Delete a blog article

List the site's automations so you can find an automation_id (e.g. to call send_mail, or to trigger from an HTTP function via @webcake/app/automation sendMail). Returns each automation's id, name, status and trigger info. Filter with 'term'. The id is what send_mail / the cms automation flow needs.

Create an automation. Checks the Automation app is installed first and installs it if needed. An automation = { name, type, status, rule }. 'rule' holds the trigger + actions (a map; shape depends on the trigger). Returns the new automation id (use it with send_mail for cms-triggered email).

Update an automation by id. Pass only the fields to change (name, description, type, status, rule).

Delete one or more automations by id.

Trigger a CMS automation to send an email (same endpoint @webcake/app/automation sendMail uses). Requires the automation_id — get it from list_automations. 'data' is the payload passed to that automation/email template.

Search stock photos (Pexels) for a page/product. IMPORTANT: the storefront only renders images served from the WebCake CDN (image domains are whitelisted) — raw Pexels URLs will NOT display. By default this re-hosts each result on the WebCake CDN and returns a ready-to-use cdn_url (cached, so repeat…

Convert external image URLs, data: URIs, or LOCAL FILE PATHS into site-hosted CDN URLs by reading/downloading each image and re-uploading it to the WebCake backend. Use this whenever the user supplies their OWN images (their URLs or files from their machine), or a page is built from a reference HTML…

Publish the whole site live — snapshots all current page sources into the live (published) version. Note: BuilderX publishes at the SITE level, not per page; publishing makes every saved page go live. Two-step safety: dry_run=true (default) describes what will happen; dry_run=false actually publishe…

Parse reference HTML into a structural blueprint (title, headings, paragraphs, images, buttons, colour palette) you can rebuild as BuilderX sections with new_section. Not a 1:1 clone.

Fetch a public URL and parse it into a structural blueprint (see ingest_html). Note: client-rendered (React/Vue) pages may return little content.

Get the BuilderX page authoring guide: page shape, the grid layout model, styling, breakpoints, forms/data, and the build workflow. Read this before building or heavily editing a page.

Get the authoritative JSON Schema (Draft 2020-12) for a page source `{ sections: [...] }` — the structural contract for every node (id/type/specials/runtime{style,config}/children/events/bindings) in the CSS-grid model. Use it as the shape to emit; validate_page enforces the semantic rules.

List all BuilderX element/component types you can place on a page, grouped by category with a one-line summary and whether each is a container.

Get the full detail of an element type: category, container flag, summary, an ATTRIBUTES reference (the meaningful specials/config keys + their purpose/allowed values, events, and dataset binding targets), and a live skeleton node (the authoritative default shape) you can copy and edit. Read this be…

List every interaction EVENT you can attach to a node: the triggers (eventName: click/hover/success/submit/…) and the actions (open_page, scroll_to, toggle, open_popup, add_to_cart, buy_now, phone_call, open_link, …) with the exact extra fields each action needs. Attach via new_element/new_section o…

List every dynamic-data BINDING target: the datasets (product, cart_item, order, order_item, post, category, customer, customer_address, …) and their exact field names ('product::product_price', …), which page type each needs (store/member/blog), and how repeater children (grid-product, cart-items, …

Build a single structurally-valid element node from the real builder factory. Returns the node — edit its specials/style, then place it in a section's children.

Build a complete section node with children laid out in the builder's vertical grid. Pass an array of element specs; each child is stacked top-to-bottom. Nest containers via the child's own 'children'. Example children: [{ "type":"text", "opts":{"text":"Welcome","style":{"fontSize":"40px"}} }, { "ty…

Build a multi-column ROW container: children laid out SIDE BY SIDE (not stacked). This is how real pages build feature cards, category tiles, footer columns, a 2-col hero, etc. The row is RESPONSIVE — it auto-collapses to fewer columns on tablet/mobile (default tablet 2, mobile 1) so cards never bec…

Return an empty but valid page source: { sections: [] }. Add sections built with new_section, then save with build_page.

Validate a page source ({ sections: [...] }). Returns errors (block saving: duplicate/missing ids, missing types) and warnings (unknown types, form fields without field_name, dangling event targets) plus stats. Always run this before build_page.

Create a brand-new page AND set its full content source in one step. Two-step safety: call with dry_run=true (default) to validate and preview, then dry_run=false to actually create + save. The source must be { sections: [...] } — build sections with new_section. Validation errors block the real sav…

Append a section to an EXISTING page's source. Reads the current source, appends your section, validates, and (when dry_run=false) saves. The section is re-id'd to avoid collisions. Build it with new_section. Two-step safety: dry_run=true (default) previews; dry_run=false saves.

List product brand tags for the site.

Create or update a product brand. Omit `id` to create; pass `is_removed:true` with an `id` to delete.

List product supplier tags for the site.

Create or update a product supplier. Omit `id` to create; `is_removed:true` to delete.

List product tags (paginated, searchable by name).

Create or update a product tag. Omit `id` to create; `is_removed:true` to delete (also detaches from products).

List ribbons (product sale badges) for the site.

Create or update a ribbon (sale badge). `type` and `name` are unique per site. Omit `id` to create; `is_removed:true` to delete.

List product materials for the site.

Create or update a product material. Supports nesting via parent_id. Omit `id` to create; `is_removed:true` to delete.

Get a single product variation by its id.

Get the product measurement-unit tree (units with exchange values).

Upsert product measurement units (full list). Each unit upserts by id; pass is_removed:true to delete one.

List blocked phone numbers (e.g. blacklisted customers).

Block customer phone numbers (upsert the given list).

Remove all blocked customer phone numbers for the site.

Get the "contact for price" config. type 1 = applied to products, 2 = applied to categories.

Set which products/categories are "contact for price" (full replace within the given type). type 1 → pass product_ids; type 2 → pass category_ids.

Get a single product category by id (includes custom sort product ids).

Create a product so the storefront has real merchandise (grid-product / slider-product bindings need this). Simple use: pass name + price (+ images, category_ids). One default variation with the price/stock is created for you. Advanced use: pass attributes (e.g. Color/Size) + variations for a multi-…

Create a product category (so grid-category / a category page has something to show, and products can be filed under it). Returns the new category id — pass it to create_product's category_ids. Image must be a hosted URL.

Create a blog/article category. Returns the new category id — pass it to create_article's category_id so posts are grouped (post-list / blog pages bind to it). Image must be a hosted URL.