Webcake Landing

vuluu2k/webcake-landing-mcp

Lets Claude build complete WebCake landing pages from plain language prompts by exposing the full element catalog, JSON schema, and validation rules. It knows the exact structure of every WebCake component (hero, form, countdown, product list, cart) and guides the AI to assemble valid page JSON with absolute positioning, CTAs, and form fields. The validate_page tool catches layout errors before persistence, and the create_page and patch_page tools push directly to your WebCake account with dry-run previews. You describe the page you want, the AI calls list_elements and get_generation_guide to learn the model, builds the JSON, validates it, and saves it. You get an editable page in the WebCake editor without touching the schema yourself. Works over stdio locally or as a hosted endpoint with JWT auth.

GitHub stars: 7
tools: 19
auth: Secret needed
transport: STDIO, HTTP
env vars: 5
last updated: Nov 5, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.toolvn.io.vn/mcp --name webcake-landing-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http webcake-landing-mcp https://mcp.toolvn.io.vn/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 19 tools

Verified live against the running server on Jun 10, 2026.

get_generation_guideReturns the page-building conventions reference: output shape, the absolute-positioning coordinate system, event vocabulary, and the recommended workflow.

Returns the page-building conventions reference: output shape, the absolute-positioning coordinate system, event vocabulary, and the recommended workflow.

No parameters. Call it with no arguments.

list_elementsList every supported element type, grouped by category, with a one-line summary and whether it is a container (can hold children).

List every supported element type, grouped by category, with a one-line summary and whether it is a container (can hold children).

No parameters. Call it with no arguments.

get_elementReturns detailed usage for one element type — or for many in a single call (BATCH MODE): summary, when to use it, key `specials` fields, a SPARSE skeleton node (the exact shape to emit — the server hydrates omitted boilerplate), and (for common types) a filled example. Pass `t...2 params

Returns detailed usage for one element type — or for many in a single call (BATCH MODE): summary, when to use it, key `specials` fields, a SPARSE skeleton node (the exact shape to emit — the server hydrates omitted boilerplate), and (for common types) a filled example. Pass `t...

Parameters* required

typestring

Single element type — backward-compat. Prefer `types` when fetching more than one.

typesarray

Multiple element types to fetch in one call (recommended for a section that needs several types, e.g. ['section','text-block','button','form','input']).

get_page_schemaReturns the full JSON Schema (Draft 2020-12) of a Webcake page source object { page: [...], settings: {...} } for structural reference and validation.

Returns the full JSON Schema (Draft 2020-12) of a Webcake page source object { page: [...], settings: {...} } for structural reference and validation.

No parameters. Call it with no arguments.

new_elementReturns a default element node for a type in the SPARSE authoring shape (fresh id, both breakpoints' seeded styles, seeded specials). Emit elements exactly like this — fill in specials + top/left coordinates; OMIT properties/runtime/empty events/config (the server hydrates the...2 params

Returns a default element node for a type in the SPARSE authoring shape (fresh id, both breakpoints' seeded styles, seeded specials). Emit elements exactly like this — fill in specials + top/left coordinates; OMIT properties/runtime/empty events/config (the server hydrates the...

Parameters* required

namestring

Optional properties.name override (layer label).

type*string

Element type to create.

new_page_skeletonReturns an empty but complete top-level page source { page:[], popup:[], settings:{...defaults}, options:{...}, cartConfigs:{} } matching the real editor shape.1 params

Returns an empty but complete top-level page source { page:[], popup:[], settings:{...defaults}, options:{...}, cartConfigs:{} } matching the real editor shape.

Parameters* required

mobileOnlyboolean

true if the page renders mobile-only.

validate_pageValidates a page source against the schema + semantic rules (unique ids, dangling event targets, children only on containers, missing field_name, top-level types) plus form-data bindings (duplicate field_name within one form, dangling option-event promoId / connectedSurvey / c...1 params

Validates a page source against the schema + semantic rules (unique ids, dangling event targets, children only on containers, missing field_name, top-level types) plus form-data bindings (duplicate field_name within one form, dangling option-event promoId / connectedSurvey / c...

Parameters* required

pagevalue

The page source object { page:[...], settings:{} } OR a JSON string of it.

search_imagesSearches Pexels stock photos (see https://www.pexels.com/api/) by short English subject queries. Returns hotlinkable URLs at several sizes (src.large for heroes/banners, src.medium for cards/thumbs), `avg_color` for matching section backgrounds, plus photographer name and attr...8 params

Searches Pexels stock photos (see https://www.pexels.com/api/) by short English subject queries. Returns hotlinkable URLs at several sizes (src.large for heroes/banners, src.medium for cards/thumbs), `avg_color` for matching section backgrounds, plus photographer name and attr...

Parameters* required

colorstring

Optional color filter: a name (red, blue, …) or a hex like '6a8f3c'.

orientationstring

Preferred shape — 'landscape' for heroes/banners, 'portrait' for tall cards, 'square' for icons/avatars.one of landscape · portrait · square

pageinteger

Result page for pagination (default 1).

per_pageinteger

Photos per query (default 5).

pickstring

With `queries`, 'best' (default) returns only the top photo per query (compact, drop-in for specials.src); 'all' returns the full result. Single-query calls always return the full result.one of best · all

queriesarray

Multiple subject queries (one per image slot) to run in parallel — recommended for a page with 2+ images so each only costs ONE round-trip.

querystring

Single subject query — backward-compat. Prefer `queries` when the page needs 2+ images.

sizestring

Minimum photo size to return (default any).one of large · medium · small

ingest_htmlParses an HTML string into a compact reference AST: title, description, og_image, language, and an array of sections classified by role (header, hero, features, about, form, cta, gallery, testimonials, pricing, faq, footer, unknown) with headings, subheadings, paragraphs, imag...2 params

Parses an HTML string into a compact reference AST: title, description, og_image, language, and an array of sections classified by role (header, hero, features, about, form, cta, gallery, testimonials, pricing, faq, footer, unknown) with headings, subheadings, paragraphs, imag...

Parameters* required

html*string

Raw HTML of a page or a section.

intentstring

How the caller intends to use the result. 'adapt' (default) — use as a layout reference and rewrite content for the user's brand. 'clone' — keep text and images close to the original.one of adapt · clone

ingest_urlFetches a public webpage (GET, 10s timeout, 2MB cap) and parses it into the same compact reference AST as ingest_html. Returns a warning when the page appears client-rendered (empty <body>) so the caller can fall back to a screenshot — Claude can analyze a screenshot natively...2 params

Fetches a public webpage (GET, 10s timeout, 2MB cap) and parses it into the same compact reference AST as ingest_html. Returns a warning when the page appears client-rendered (empty <body>) so the caller can fall back to a screenshot — Claude can analyze a screenshot natively...

Parameters* required

intentstring

url*string

Public HTTP(S) URL of the page to fetch.

list_organizationsReturns the account's Webcake organizations (id, name, is_default). The default org (type===1, usually the personal workspace) is where pages normally go. Needs WEBCAKE_API_BASE + WEBCAKE_JWT.

Returns the account's Webcake organizations (id, name, is_default). The default org (type===1, usually the personal workspace) is where pages normally go. Needs WEBCAKE_API_BASE + WEBCAKE_JWT.

No parameters. Call it with no arguments.

create_pagePersists a page source to the configured Webcake backend: creates a NEW page and saves the source (source-only — opens in the editor where re-saving renders it). Validates first. DEFAULTS to dry_run=true (validates, caches the source as draft_id, returns the HTTP request it WO...5 params

Persists a page source to the configured Webcake backend: creates a NEW page and saves the source (source-only — opens in the editor where re-saving renders it). Validates first. DEFAULTS to dry_run=true (validates, caches the source as draft_id, returns the HTTP request it WO...

Parameters* required

draft_idstring

A draft_id from a previous create_page call (validation failure, dry_run=true, or a timed-out/failed create). Loads the cached source — no need to re-send the full JSON. Use for dry-run → real call...

dry_runboolean

Default TRUE — validate, cache the source as draft_id, and preview the request without sending. Set false to actually create.

namestring

Page name (default 'AI Page').

organization_idstring | number

Organization to create the page in (from list_organizations). Omit for a personal page; falls back to WEBCAKE_ORG_ID env if set.

sourcevalue

Page source { page, popup, settings, options, cartConfigs } (object or JSON string). Required unless draft_id is given. Author elements SPARSE — only id, type, responsive.<bp>.styles for BOTH break...

list_pagesLists the pages owned by the account (id, name, organization_id, updated_at), most-recent first. Needs WEBCAKE_API_BASE + WEBCAKE_JWT.

Lists the pages owned by the account (id, name, organization_id, updated_at), most-recent first. Needs WEBCAKE_API_BASE + WEBCAKE_JWT.

No parameters. Call it with no arguments.

find_pagesSearches the account's pages by name, domain, and/or page id so you can locate the page to edit, then pass its id to get_page → update_page/add_section. Filters are AND-combined (e.g. name='sale' + domain='shop.com'). Each result includes id, name, organization_id, custom_doma...4 params

Searches the account's pages by name, domain, and/or page id so you can locate the page to edit, then pass its id to get_page → update_page/add_section. Filters are AND-combined (e.g. name='sale' + domain='shop.com'). Each result includes id, name, organization_id, custom_doma...

Parameters* required

domainstring

Case-insensitive substring of the page's domain (matches custom_domain OR default_domain).

limitinteger

Max results (default 50, capped at 100).

namestring

Case-insensitive substring of the page name to match.

page_idstring

Exact page id — narrows to that single page (useful to confirm it exists/owned).

get_pageFetches an existing page's decoded source tree { page, popup, settings, options, cartConfigs } plus name and organization_id. By DEFAULT the source is COMPACTED: boilerplate every element shares (properties/runtime/empty events+children/per-breakpoint config + factory-default...2 params

Fetches an existing page's decoded source tree { page, popup, settings, options, cartConfigs } plus name and organization_id. By DEFAULT the source is COMPACTED: boilerplate every element shares (properties/runtime/empty events+children/per-breakpoint config + factory-default...

Parameters* required

compactboolean

Default TRUE — strip factory-default boilerplate from every element (sparse shape, far fewer tokens). false returns the raw stored tree.

page_id*string

The page id (from list_pages or a URL).

update_pageOverwrites an EXISTING page's source with an edited tree (source-only; re-render in the editor for preview/publish). Validates first. DEFAULTS to dry_run=true (validates, caches the source as draft_id, previews the request, token masked); dry_run=false to actually save. Accept...4 params

Overwrites an EXISTING page's source with an edited tree (source-only; re-render in the editor for preview/publish). Validates first. DEFAULTS to dry_run=true (validates, caches the source as draft_id, previews the request, token masked); dry_run=false to actually save. Accept...

Parameters* required

draft_idstring

A draft_id from a previous update_page call (dry_run=true or a timed-out/failed update). Loads the cached source — no need to re-send the full JSON. Use for dry-run → real call transitions and retr...

dry_runboolean

Default TRUE — validate, cache the source as draft_id, and preview without sending. Set false to actually save.

page_idstring

The page id to update (must be owned by the account). Required unless draft_id is given (the page_id is stored in the draft).

sourcevalue

The edited page source { page, popup, settings, options, cartConfigs } (object or JSON string). Required unless draft_id is given. The compacted tree from get_page can be edited and sent back AS-IS...

add_sectionAppends one or more SECTIONS to an existing page WITHOUT re-sending the whole source — the incremental-build path that avoids large create_page payloads. The backend appends section(s) to the END of `page` server-side and rejects duplicate element ids, so the caller sends only...4 params

Appends one or more SECTIONS to an existing page WITHOUT re-sending the whole source — the incremental-build path that avoids large create_page payloads. The backend appends section(s) to the END of `page` server-side and rejects duplicate element ids, so the caller sends only...

Parameters* required

draft_idstring

A draft id returned by a previous add_section call (dry_run=true or validation failure). Loads the cached section payload — no need to re-send the sections JSON. Use for dry-run → real call transit...

dry_runboolean

Default TRUE — validate the section(s) and preview the request without writing. Set false to actually append.

page_id*string

The page id to append to (from create_page or list_pages; must be owned by the account).

sectionsvalue

One section node, or an array of section nodes, to append to the END of `page` (object/array or JSON string). Each is a normal section element { id, type:'section', responsive, children, … } with a...

patch_pageEdits a page by element id WITHOUT re-sending the whole source — the surgical-edit and fix-after-error path. Targets EITHER a live page (page_id) OR a cached draft source (draft_id). Draft sources come from: (a) create_page — failed validation or timed-out network call → patch...4 params

Edits a page by element id WITHOUT re-sending the whole source — the surgical-edit and fix-after-error path. Targets EITHER a live page (page_id) OR a cached draft source (draft_id). Draft sources come from: (a) create_page — failed validation or timed-out network call → patch...

Parameters* required

draft_idstring

Commit or fix a CACHED source: from create_page (failed/timed-out → new page created once valid), add_section (dry_run or failure → sections appended), or update_page/live-page patch (timed-out/fai...

dry_runboolean

Default TRUE — load, merge, validate and preview the resulting save WITHOUT writing. Set false to actually save.

page_idstring

Edit a LIVE page by id (from create_page, list_pages, or find_pages; must be owned by the account). Provide page_id OR draft_id. For a sections or update draft_id you may also pass page_id here to...

patchesvalue

One op object or an array of them (object/array or JSON string). Each targets an element by id: {op:'update',id,type?,specials?,styles?:{desktop?,mobile?},config?:{desktop?,mobile?},events?,propert...

publish_pagePublishes an EXISTING page: saves the stored source as a new version and creates/updates its page_published record (live status), optionally attaching a custom domain/path. NOT needed for the preview link — /preview/<page_id> on the preview host renders the stored source direc...4 params

Publishes an EXISTING page: saves the stored source as a new version and creates/updates its page_published record (live status), optionally attaching a custom domain/path. NOT needed for the preview link — /preview/<page_id> on the preview host renders the stored source direc...

Parameters* required

custom_domainstring

Optional custom domain to serve the page at (e.g. 'shop.example.com' — must already point at Webcake). Omit to publish without a domain (served at the preview-host URL).

custom_pathstring

Optional path under the custom domain (e.g. 'sale').

dry_runboolean

Default TRUE — preview the request without sending. Set false to actually publish.

page_id*string

The page id to publish (must be owned by the account).

Configuration

WEBCAKE_JWTsecret

Webcake backend JWT; required only for the persistence tools (create/update/list pages).

WEBCAKE_ENV

Webcake environment preset that fills the API/app/builder base URLs.

WEBCAKE_API_BASE

Override for the Webcake API base URL (takes precedence over WEBCAKE_ENV).

WEBCAKE_ORG_ID

Default Webcake organization id for the persistence tools.

PEXELS_API_KEYsecret

Optional Pexels API key for search_images; without one a shared hosted proxy is used.

Readme

Webcake WebCake Landing MCP

English · Tiếng Việt

Describe a landing page in plain words — your AI builds it, checks it, and ships it straight to WebCake.

⭐ If this saves you an afternoon of dragging boxes, give it a star — it's a one-dev project and every star keeps it alive.

"Build a landing page for my coffee shop — a hero with a sign-up button, a 3-feature section, and a lead form. Save it to my workspace."

View the full README on GitHub

Details

Repository: github.com/vuluu2k/webcake-landing-mcp
Website: github.com/vuluu2k/webcake-landing-mcp#readme
Category: Data & Analytics
Package: webcake-landing-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Jun 10, 2026

Related Data & Analytics MCP servers

View all

Octocrawl77777r7/octocrawlPages, crawls and URL batches as clean Markdown and JSON for AI agents, with an Evidence Record.6stars

HasData Amazonhasdata/amazon-mcpAmazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.6stars

HasData Walmarthasdata/walmart-mcpWalmart search, product pages and customer reviews on walmart.com and walmart.ca, as JSON.6stars

Amazon Mcppangolinfo/pangolinfo-mcpAmazon data MCP: products, reviews, niches, WIPO design/IP + US litigation, AI search & trends.6stars

TLE Satellite Trackerivanstan/tle-apiAccess TLE orbital data for thousands of satellites including ISS, Starlink, and Hubble.0stars

JustOneAPIjustoneapi-official/justoneapi-mcpDiscover social and commerce APIs without login; authenticate for API calls and account data.6stars