WebCake Storefront MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WEBCAKE_ENV | No | Environment preset: local, staging, or prod (default). | prod |
| WEBCAKE_TOKEN | Yes | Bearer JWT token for authentication. | |
| PEXELS_API_KEY | No | Optional Pexels API key for image search. | |
| WEBCAKE_API_URL | No | Override the API base URL. | |
| WEBCAKE_APP_URL | No | Override the app base URL (for login). | |
| WEBCAKE_SESSION_ID | Yes | Session ID sent as x-session-id header. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_intake_guideA | Get the INTAKE questionnaire + build flow to run BEFORE creating a new site/store/page. Call this at the start of any fresh build: ask the user this one short batch (plain words, with defaults), restate the plan, get a yes, THEN build. Skip only for tiny edits, data questions, or when the user already gave the brief / says 'just do it'. |
| get_current_contextA | Show current connection context: which site_id, API URL, session, and account info. Call this first to confirm you're working on the right site |
| list_my_sitesA | List all sites accessible by the current account. Use this to find a site_id before switching |
| create_siteA | Create a brand-new storefront site for the current account, then (by default) switch to it and return an EMPTY, CLEAN site (no sample products/categories) ready for element composition. The backend auto-seeds off-theme sample products + categories (and a sample blog); by default this tool DELETES that seed right after creating the site (keep the non-deletable default "All" category) so you start from a blank, on-theme store. Pass keep_seed:true to keep the sample data. The site has NO pages — after this, compose a homepage from elements: get_build_guide → new_section/new_element → build_page (type:'main', is_homepage:true). Note: free accounts are limited to 4 sites (creation fails with a quota error past that). |
| switch_siteA | Switch to a different site by site_id. All subsequent tool calls will target the new site. The choice is saved to local database — next session will auto-connect to this site. Use list_my_sites first to find the site_id |
| update_authA | Update authentication credentials. All values are saved to local database — next session auto-restores them. Get token and session_id from browser DevTools → Network tab → copy from any API request headers |
| toggle_confirm_modeA | Toggle update confirmation mode. Controls whether update tools ask for user confirmation before saving.
Call this tool when the user says things like: → "tự động xác nhận" / "auto confirm" / "không cần hỏi" / "don't ask" / "apply directly" → mode: "auto_apply" → "hỏi trước khi lưu" / "luôn hỏi" / "always ask" / "confirm before saving" / "xác nhận trước" → mode: "always_confirm" |
| list_cms_filesA | List all CMS files (HTTP functions, cron jobs, ...) for the site |
| create_cms_fileA | Create a new CMS file. Types: "http_function", "jobs_config", "default" |
| update_cms_fileC | Update the code content of an existing CMS file |
| get_http_functionA | Get the main HTTP function file. Choose the right mode for your task:
|
| get_http_function_snippetA | Read specific function(s) by name. Much more token-efficient than reading the full file |
| edit_http_functionA | Edit the HTTP function file by function name — best for targeted changes (fix a bug, rename, add one function). For writing multiple new functions or major refactors, use update_http_function with full content instead. Actions:
|
| update_http_functionA | Write the FULL HTTP function file content. Best for: writing new features, major refactors, or changes that touch multiple functions. For small targeted edits (fix one function, add one function), use edit_http_function instead. After update, auto-deploys to the bundle service |
| run_functionA | Run a deployed HTTP function. function_name excludes method prefix. Example: "get_Products" → function_name="Products", method="GET" |
| debug_functionA | Run JS code in debug mode (without deploying). Returns execution result and console logs |
| save_file_versionA | Save a version snapshot of a CMS file for rollback |
| get_file_versionsA | View version history of a CMS file. Each version includes its saved content — to restore, pass that content back to update_http_function (the http_function file) or update_cms_file, or use restore_file_version. |
| restore_file_versionA | Roll a CMS file back to a saved version in one step: reads the version's content and writes it back to the file. Omit version_id to restore the most recent snapshot. Tip: save_file_version on the current content first if you want an undo point. |
| toggle_debug_renderB | Toggle debug render mode for a CMS file |
| list_pagesA | List all pages of the site (metadata only, without source) |
| get_page_sourceA | Get page source overview: section count, element type counts, and all custom CSS classes. Use this first, then use search_page_elements to find specific elements |
| search_page_elementsA | Search/filter elements within a page source. Returns matching elements with full detail (id, type, style, text, classes, etc.). Examples:
|
| create_pageA | Create a new (empty) page. For a page with content use build_page instead. type is a KIND (main/store/member/blog/custom/error/maintain) mapped to the numeric backend type; pass seo so it doesn't publish with an empty title. ONE page per site for main (homepage) / error / maintain, and slugs are unique per site — a duplicate is refused with the existing page_id to edit instead; only 'custom' pages can be created over and over. |
| update_pageC | Update page properties (name, slug, settings, custom code) |
| get_site_custom_codeA | Get custom code of the site (CSS/JS). Two modes:
|
| update_site_custom_codeA | Update custom code (CSS/JS) for the entire site. Only sends fields you specify — others remain unchanged. IMPORTANT: Before calling, you MUST read existing code with get_site_custom_code first, then show the user what will change and get explicit confirmation. NEVER update without user approval.
|
| append_site_custom_codeA | Append or prepend code to a custom code field WITHOUT reading the existing content first. Use this when you need to ADD new CSS rules, JS code, or script tags — no need to read first. For full rewrites, use update_site_custom_code instead. |
| delete_pageB | Delete a page |
| get_page_versionsB | View version history of a page |
| list_page_contentsC | List multi-language contents of a page |
| update_page_contentA | Create/update page content for a specific language. IMPORTANT: Before calling, you MUST read existing content with list_page_contents first, then show the user what will change and get explicit confirmation. NEVER update without user approval. |
| get_page_elementA | Get full detail of a single element by its ID (e.g. 'TEXT-3', 'BUTTON-1', 'SECTION-2'). Returns style, config, specials, events, bindings, responsive, and children IDs |
| update_page_elementA | Update properties of a specific element in page source. Two-step process: STEP 1: Call with dry_run=true (default) → returns diff of what will change. STEP 2: Show the diff to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Merge rules: style/config/specials = shallow merge, responsive = merge by bp key. events/bindings = REPLACE the whole array — pass the COMPLETE list (read it first with get_page_element so you don't drop the others); entries are auto-normalized (id + eventName filled in, so you can pass just { action, ...fields } / { target }). |
| update_page_elementsA | Batch update multiple elements in one page. Two-step process: STEP 1: Call with dry_run=true (default) → returns per-element diff. STEP 2: Show all diffs to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Same merge rules: style/config/specials = shallow merge, events/bindings = replace. |
| update_page_sourceA | Directly update the full page source JSON. IMPORTANT: Before calling this tool, you MUST:
|
| list_collectionsA | List all database collections (tables) for the site. Returns collection names, table names, and field counts. Use get_collection for full schema details |
| get_collectionA | Get a specific collection's details including full schema (field names, types, constraints, references) and records |
| query_collection_recordsA | Query records from a collection (custom data table) by table name. Supports paging + an optional |
| create_collectionA | Create a new collection (custom data TABLE). It starts with the system columns (id/inserted_at/updated_at/creator_id); pass |
| update_collection_columnsA | Add or change a collection's custom columns. Reads the current schema, then PATCHes it with the system columns + your custom columns (the PATCH replaces the whole schema, so omitting a column drops it). |
| delete_collectionA | Delete a collection (table) and all its records by id. Irreversible. |
| list_articlesA | List blog articles (metadata only, without HTML content). Use get_article for the full content. Pass term to search by title/slug. Pass category_id to list the posts filed under one blog category — that view is the public one, so hidden posts and posts scheduled in the future are left out. |
| get_articleA | Get article details by ID (includes the full HTML content) |
| create_articleA | 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 under those categories (it is also auto-filed under the default category). Image URLs must be hosted (search_images / upload_images). The backend generates the id and slug. |
| update_articleA | Update a blog article. Only the fields you pass are changed — each one becomes a command in the same dashboard pipeline create_article uses. NOTE: renaming regenerates the slug, so pass slug in the SAME call if you want a custom one (it is applied after the rename). |
| delete_articleA | Delete blog articles (soft delete — they disappear from the site) |
| list_customersA | List/search the site's customers (browse or segment). Pass |
| find_customerA | Find a customer by ID, phone number, or email |
| list_productsA | List products of the site (metadata only: id, name, slug, price, image, status). Use get_product for full details |
| get_productA | Get full product details by ID: name, description, price, variations, images, attributes, SEO, etc. |
| search_productsB | Search products by keyword. Returns matching products with basic info |
| list_categoriesA | List all product categories of the site |
| create_productA | 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-SKU product. Images must be HOSTED URLs — get them from search_images or upload_images first. The backend generates id, slug and publishes the product. |
| create_product_categoryA | 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_blog_categoryA | 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. |
| update_productA | Update an existing product. Pass product_id + only the fields to change. To change price/stock, pass variations (get_product first to see the existing variation shape). Images must be hosted CDN urls (search_images cdn_url / upload_images). |
| set_product_publishedA | Publish or unpublish one or more products quickly (without a full update). |
| delete_productB | Delete one or more products by id. |
| update_product_categoryA | Update a product category (name, image, description, or visibility). Pass id + fields to change. |
| delete_product_categoryB | Delete one or more product categories by id. |
| list_ordersA | List orders of the site (metadata only). Use get_order for full details including items |
| get_orderA | Get full order details by ID: customer info, items, payment, shipping, discounts, etc. |
| count_orders_by_statusA | Get order count grouped by status. Useful for dashboard overview |
| get_site_infoA | Get full site information: name, domain, settings (colors, typography, layout, language, payment methods, etc.) |
| list_themesA | List all custom themes of the site. Returns theme name, colors, typographies, transitions, and which one is active |
| list_template_themesA | Search/list the public Webcake template marketplace (api.storecake.io). Use to match customer brief against existing templates by keyword. Returns id, name, preview_url, thumbnail, categories |
| semantic_search_themesA | Semantic search across the theme marketplace using bge-m3 embeddings (cosine similarity). Use when the brief is a natural-language description of industry + features (e.g. 'website mỹ phẩm có popup minigame và loyalty'), not just keywords. Returns top matches with theme_id, score, name, preview_url, thumbnail, description_vi/en |
| create_site_from_templateA | Create a NEW site from a marketplace TEMPLATE (the dedicated "use this template" API). Clones the template's pages, global sections, cart, popups, styles and fonts into a fresh site. Pick a template with semantic_search_themes / list_template_themes, then pass its theme_id here. Switches to the new site so you can immediately edit layout/content with update_page_element(s), colours/fonts via the site-style tools, then publish_site. |
| list_appsA | List the site's installed applications (type, status, settings). App type codes: 0=product_review, 1=articles_review, 2=automation, 3=telegram, 4=affiliates, 5=multilingual, 6=appointment, 7=send_email, 8=botcake, 9=sale_channel, 10=product_design, 11=auth_otp, 12=personal_product_design, 14=course, 15=zalo_mini_app, 16=cms, 17=recaptcha, 18=pwa. |
| get_appA | Get one installed app by its type code (returns null if not installed). App type codes: 0=product_review, 1=articles_review, 2=automation, 3=telegram, 4=affiliates, 5=multilingual, 6=appointment, 7=send_email, 8=botcake, 9=sale_channel, 10=product_design, 11=auth_otp, 12=personal_product_design, 14=course, 15=zalo_mini_app, 16=cms, 17=recaptcha, 18=pwa. You may pass the number or the name. |
| install_appA | Install (register) an application on the current site so its features become usable. For example, automations need the "automation" app installed first. App types: 0=product_review, 1=articles_review, 2=automation, 3=telegram, 4=affiliates, 5=multilingual, 6=appointment, 7=send_email, 8=botcake, 9=sale_channel, 10=product_design, 11=auth_otp, 12=personal_product_design, 14=course, 15=zalo_mini_app, 16=cms, 17=recaptcha, 18=pwa. |
| uninstall_appA | Uninstall (remove) an installed application from the current site.
Pass the app's subscription id — get it from list_apps (the |
| update_appA | Update an installed app's configuration. Pass the app subscription id and an |
| update_app_reviewA | 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 |
| list_promotionsA | List all promotions/discounts of the site (metadata only). Use get_promotion for full details |
| get_promotionA | Get full promotion details by ID: name, type, schedule, discount rules, coupon settings, items, bonus products, etc. |
| get_promotion_itemsA | Get products/variations/categories attached to a promotion. Returns items with discount details (fixed_prices, level_info, coupon_item_info) |
| get_active_promotionsA | Get all currently active promotions (is_activated=true and within start_time/end_time range) |
| search_promotionsC | Search/filter promotions with advanced filters: by type, status (coming_soon/in_progress/finished), keyword, date range |
| list_combosA | List all combo/bundle products of the site. Use get_combo_items for combo composition details |
| get_combo_itemsA | Get items (products/variations) and bonus products that compose a combo. Returns combo_items (required items with count) and bonus_items (free gifts) |
| list_global_sourcesA | List global sources (cart, popup, etc.). Returns compact summary per source. Always provide component to filter by type — the API may not return all types without a filter. |
| get_source_cartA | Get all cart global sources with compact tree view. Shows full element hierarchy — no need to call get_global_source_detail separately. |
| get_global_source_detailA | Get full detail of a global source — compact tree view showing all elements. Each line: ID [type] "text" .class [events] [bindings] (children_count). Provide component for faster lookup; omit if you already called list_global_sources. |
| search_global_source_elementsA | Search/filter elements within a global source. No component param needed. Examples:
|
| get_global_source_elementA | Get full detail of a single element (style, config, specials, events, bindings, responsive, children). |
| update_global_source_elementA | Update a single element within a global source. Two-step process: STEP 1: Call with dry_run=true (default) → returns diff of what will change. STEP 2: Show the diff to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Merge rules: style/config/specials = shallow merge, responsive = merge by bp key. events/bindings = REPLACE the whole array — pass the COMPLETE list (read it first); entries are auto-normalized (id + eventName filled in). |
| update_global_source_elementsA | Batch update multiple elements in one global source. Two-step process: STEP 1: Call with dry_run=true (default) → returns per-element diff. STEP 2: Show all diffs to the user and ask for confirmation. NEVER proceed without explicit user approval. STEP 3: Only after user confirms, call again with dry_run=false to apply. IMPORTANT: You MUST show the diff to the user and get explicit "yes/ok/confirm" before calling with dry_run=false. Skipping confirmation risks data loss. Same merge rules: style/config/specials = shallow merge, events/bindings = replace. |
| create_global_sourceB | Create a new global source component. Component types: "cart-droppable" (cart), "popup", or any custom type. |
| update_global_sourceA | Replace full source of a global source. IMPORTANT: Before calling this tool, you MUST:
|
| delete_global_sourceA | Delete a global source and its published version |
| get_global_source_contentsB | Get multilingual contents for global sources by component type |
| update_global_source_contentsA | Update multilingual contents (upsert). Each entry: global_source_id, language_code, content. IMPORTANT: Before calling, you MUST read existing contents with get_global_source_contents first, then show the user what will change and get explicit confirmation. NEVER update without user approval. |
| list_global_sectionsA | List reusable global sections (Header, Footer, shared content blocks) — SLIM summary only. Each entry: id, name, slot (header/footer/block), element count + type histogram + custom classes. The full element tree is large, so it is NOT returned here — drill in with get_global_section (compact tree), search_global_section_elements, or get_global_section_element. |
| get_global_sectionA | Get one global section as a COMPACT tree (3-5x fewer tokens than raw JSON). Each line: ID [type] "text" .class [Nbind] [Nev] (children_count). Use this to learn how a real Header/Footer/block is composed before building your own. |
| search_global_section_elementsA | Search/filter elements within a global section (Header/Footer/block) without dumping the whole tree. Filter by type, id substring, custom_class, text, or has_bind / has_events / has_custom_class. |
| get_global_section_elementA | Get full detail (style, config, specials, events, bindings, responsive bp1..bp4, children IDs) of a single element inside a global section. |
| create_global_sectionA | Create a reusable global section (Header / Footer / shared block) the way the builder does: persists a global_section record AND embeds the same section node into page sources so it actually renders across the site (header → top of every page, footer → bottom). Build the section first with new_section (give it a real bg/padding + logo/menu/links), then pass it here. Two-step safety: dry_run=true (default) previews which pages change; dry_run=false performs the atomic save. |
| delete_global_sectionA | Delete a global section (Header/Footer/block) and remove its node from every page source. Two-step safety: dry_run=true (default) shows which pages would change; dry_run=false performs the atomic save. |
| read_cached_resultA | Read a slice of a large cached result produced by another tool (look for "cached":true + a cache_id in its output). Page through with offset/length; the response reports next_offset + remaining_chars until done. |
| list_cached_resultsA | List the large results currently held in the session cache (id, label, size, age). |
| scan_unique_imagesA | Scan all images used across page sources, global sources, and global sections. Returns a unique list of image URLs with which elements use each one. Useful for: image audit, finding broken/duplicated CDN URLs, bulk replace planning, theme migration. Scans every string field in the source tree (config.src, style.background-image, etc.) and CSS url(...) refs — wide net catches all variants. |
| read_imageB | Fetch an image URL and return its bytes for vision analysis by the AI client. Pair with scan_unique_images to inspect images already on the site. After receiving the image, describe it (subject, style, palette, composition, mood, lighting, background, notable_details) to build an image-generation brief. Describe the image with these fields, useful as input for new image generation:
|
| list_image_elementsA | Find all image elements across pages + global sources, with element_id, current alt, src, and the field path where alt is/should be written. Use as the first step before generating alt text via vision (read_image) and writing back with set_image_alts. Note: global_sections are read-only via the API and are not included. |
| set_image_altsA | Batch-write alt text for image elements across pages + global sources. Groups updates by source so each source is fetched + saved exactly once. Workflow: list_image_elements → read_image (per src) → describe → set_image_alts(items). If alt_path is omitted, it is auto-detected via the same probe used by list_image_elements (config.image.alt → config.alt → specials.alt). |
| fetch_images_for_alt_fillA | One-shot helper for filling image_alt across the site. Returns image bytes + element metadata in a single response so Claude can describe everything in one pass, then call set_image_alts once. Workflow:
The pre-built "items" template at the end contains placeholders — fill in "alt" and call set_image_alts. |
| read_imagesA | Batch fetch multiple image URLs in parallel. Use when comparing several references or extracting motifs across a set. Capped at 5 images per call to keep context manageable. For each image, describe subject/style/palette/composition/mood; then synthesize common themes for the brief. Describe the image with these fields, useful as input for new image generation:
|
| get_build_guideA | 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_page_schemaA | Get the authoritative JSON Schema (Draft 2020-12) for a page source |
| list_elementsA | 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_elementA | 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 before authoring/editing an element so you set the right keys. |
| list_eventsA | 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 opts.events (ids are auto-minted, e.g. opts.events=[{ action:'add_to_cart', open_page:'cart' }]). |
| list_bindingsA | 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, post-list) bind per-item. Attach via new_element opts.bindings (ids auto-minted, e.g. opts.bindings=[{ target:'product::product_price' }]). |
| new_elementA | 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. |
| new_sectionB | 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"}} }, { "type":"button", "opts":{"text":"Shop now"} }] |
| new_rowA | 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 become cramped slivers. Place the returned node as a child inside a section (section children still stack vertically; nest a row for horizontal layout). Example children: [{ "type":"container", "children":[{"type":"image","opts":{...}},{"type":"text","opts":{...}}] }, { ... }, { ... }] |
| new_page_skeletonA | Return an empty but valid page source: { sections: [] }. Add sections built with new_section, then save with build_page. |
| validate_pageA | 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. |
| build_pageA | 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 save. ONE page per site for type main (homepage) / error / maintain, and slugs are unique per site: a duplicate is refused (dry_run reports blocked:true) and you get the existing page_id to edit instead. Only 'custom' pages can be created over and over. |
| add_sectionA | 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. |
| search_imagesA | 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 repeats are free). Use cdn_url for image src / product images. Requires the PEXELS_API_KEY environment variable. |
| upload_imagesA | 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/URL. The returned CDN URLs go straight into an image element's specials.src / runtime.config.src, or a product/category image. This is REQUIRED for any external image (incl. Pexels search results) because the storefront only renders whitelisted WebCake-CDN image domains. Results are cached per site, so re-uploading the same source is free. Processes up to 20 entries per call in parallel; non jpeg/png/webp inputs are converted to JPEG. UPLOADS BY DEFAULT (dry_run defaults to FALSE — this touches no account data): returns an "images" map (original source → hosted URL). Pass dry_run:true to only preview the entries that WOULD be processed (local paths report whether the file exists + its size) without any network/filesystem upload. Local file paths are only permitted when the MCP server runs locally (stdio); on the remote HTTP transport they are rejected per-entry. |
| publish_siteA | 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 publishes. |
| ingest_htmlA | 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. |
| ingest_urlA | Fetch a public URL and parse it into a structural blueprint (see ingest_html). Note: client-rendered (React/Vue) pages may return little content. |
| start_page_draftA | Start a page draft (no network). Build a multi-section page safely: cache each section with add_draft_section, then commit_page_draft persists it to the backend INCREMENTALLY (resumable on timeout). Use this instead of build_page for large/multi-section pages. The draft cache is DISPOSABLE (Redis on the remote server when REDIS_URL is set, in-memory otherwise; sliding ~2h TTL) — if a draft is ever lost, just re-send the sections, never a failure. ONE page per site for type main (homepage) / error / maintain, and slugs are unique per site: the draft is refused up-front with the existing page_id to edit instead. Only 'custom' pages can be created over and over. |
| add_draft_sectionA | Append ONE section to a local page draft (NO network — this is the durable per-section cache step that can't time out). The section is re-id'd to avoid collisions and quick-validated; warnings are surfaced but never block. Build the section with new_section. |
| get_page_draftA | Inspect a local page draft: its meta, the section ids, total section count, and (if a commit is in progress) the page_id + committed_count. |
| list_page_draftsA | List local page drafts for the current site (summaries only: id, name, slug, type, section count, commit progress, updated_at). |
| commit_page_draftA | Persist a local page draft to the backend INCREMENTALLY (one section per request, 120s timeout each) so no single huge request can time out. dry_run=true (default) validates the assembled page and previews stats. dry_run=false creates the page then appends sections one at a time, saving progress after each. RESUMABLE: if a request fails mid-commit, the draft keeps its page_id + committed_count — just call commit_page_draft again to continue from where it stopped. |
| clear_page_draftA | Delete a local page draft (does NOT delete any backend page already created from it). |
| list_tool_groupsA | List every WebCake tool group, how many tools it has, and whether it is loaded natively or reached on-demand via search_tools + invoke_tool. |
| search_toolsA | Find WebCake tools by keyword across the FULL catalog — including capabilities NOT loaded natively (marketing/CRM, translations, media, appointments, affiliate, reviews, domains/SEO/shipping, brands/tags/ribbons, courses, sale channels, automation…). Returns name, group, description and JSON input schema. Then run one with invoke_tool. |
| invoke_toolA | Run any WebCake tool by exact name with its arguments (discover names + schemas via search_tools). Arguments are validated before running. Use this for tools that are not loaded natively. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 135 tools
The tools are organized into recognizable families (pages, global sources/sections, products, CMS files, images) and most descriptions clarify scope well. However, the volume of near-parallel names such as get_source_cart vs get_global_source_detail, search_global_section_elements vs search_global_source_elements, and update_page_element(s) vs update_page_source means an agent has to read carefully to avoid picking the wrong variant.
Most tools follow a readable snake_case verb_noun pattern (list_*, get_*, create_*, update_*, delete_*). There are notable deviations like new_section/new_element/new_row instead of create_*, build_page vs create_page, edit_http_function vs update_http_function, and set_image_alts, but the overall style is still recognizable and not chaotic.
135 tools is far beyond a well-scoped surface and clearly falls in the extreme mismatch range. Even though WebCake covers many domains, the sheer number creates a heavy selection burden and overlaps with the on-demand search_tools/invoke_tool catalog.
The tool set covers an unusually broad set of workflows: pages, drafts, global sources/sections, products, categories, collections, CMS files, themes, apps, images, orders/customers/promotions reads, and publishing. There are some gaps such as native promotion mutation, global section editing, and CMS file deletion, but search_tools/invoke_tool and documented workarounds mitigate most dead ends.