frameworc-mcp 0.2.0 → 0.4.0

package/dist/index.js

@@ -13,6 +13,17 @@ const CATALOGUE_URI = "frameworc://blocks";
 (0, sites_js_1.warnIfWorldReadable)();
 const session = new session_js_1.Session();
 const client = new api_client_js_1.ApiClient(session);
+/** Resolves the block-op target from page_id / prefill_id args. */
+function blockHost(args) {
+    const hasPage = args.page_id !== undefined && args.page_id !== null;
+    const hasPrefill = args.prefill_id !== undefined && args.prefill_id !== null;
+    if (hasPage === hasPrefill) {
+        throw new Error("Pass exactly one of page_id / prefill_id.");
+    }
+    return hasPrefill
+        ? { type: "prefill", id: Number(args.prefill_id) }
+        : { type: "page", id: Number(args.page_id) };
+}
 const tools = [
     {
         name: "use_site",
@@ -37,12 +48,34 @@ const tools = [
             properties: {},
         },
     },
+    {
+        name: "list_cms_sites",
+        description: "List the multisite sites configured INSIDE the pinned OctoberCMS install (languages, regional variants). Returns [{id, name, code, locale, is_enabled, is_primary}]. Call this before creating content on a multi-language project so you know which site_id to target. Not to be confused with list_sites, which lists separate CMS installs from your local config file.",
+        inputSchema: {
+            type: "object",
+            properties: { site_url: { type: "string" } },
+        },
+    },
+    {
+        name: "use_cms_site",
+        description: "Pin which multisite site (language) subsequent calls read and write. Pass the id from list_cms_sites, or null to go back to the primary site. Every page/single tool also accepts a one-off site_id argument that overrides this.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site_id: { type: ["integer", "null"], description: "Site id from list_cms_sites, or null for the primary site." },
+            },
+            required: ["site_id"],
+        },
+    },
     {
         name: "list_pages",
-        description: "List all FrameworC pages on the pinned site.",
+        description: "List all FrameworC pages on the pinned site (and pinned CMS site, if set).",
         inputSchema: {
             type: "object",
-            properties: { site_url: { type: "string", description: "Override the pinned site URL for this call." } },
+            properties: {
+                site_url: { type: "string", description: "Override the pinned site URL for this call." },
+                site_id: { type: "integer", description: "Override the pinned multisite site for this call." },
+            },
         },
     },
     {
@@ -53,6 +86,7 @@ const tools = [
             properties: {
                 id: { type: "integer", description: "Page id." },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
             required: ["id"],
         },
@@ -73,6 +107,7 @@ const tools = [
                     required: ["page"],
                 },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
             required: ["payload"],
         },
@@ -86,6 +121,7 @@ const tools = [
                 id: { type: "integer" },
                 payload: { type: "object" },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
             required: ["id", "payload"],
         },
@@ -98,101 +134,383 @@ const tools = [
             properties: {
                 id: { type: "integer" },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
             required: ["id"],
         },
     },
     {
         name: "add_block",
-        description: "Append a block to a page's builder. Optional `position` (1-indexed) inserts at that position; otherwise appends at the end. The `block` arg has the shape { content_group, base, content, form_entry? / menu_entry? / prefill_entry? } per the catalogue.",
+        description: "Append a block to a page's builder — or a prefill's, by passing prefill_id instead of page_id. Optional `position` (1-indexed) inserts at that position; otherwise appends at the end. The `block` arg has the shape { content_group, base, content, form? } per the catalogue — `form` sits at block level, while Menu and Prefill references live at `content.menu` and `content.block`. If the section you are adding already exists on another page, do NOT copy it: reference its Prefill entry with a `Prefill` block (extract_block_to_prefill turns an existing page block into one).",
         inputSchema: {
             type: "object",
             properties: {
-                page_id: { type: "integer" },
+                page_id: { type: "integer", description: "Page to edit. Pass exactly one of page_id / prefill_id." },
+                prefill_id: { type: "integer", description: "Prefill entry to edit instead of a page." },
                 block: { type: "object" },
                 position: { type: "integer" },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
-            required: ["page_id", "block"],
+            required: ["block"],
         },
     },
     {
         name: "update_block",
-        description: "Replace a single block by id (the row id returned by get_page's builder[].id). The new `block` must include `content_group` (matching or changing the block type) plus `base` + `content`.",
+        description: "Replace a single block by id (the row id from get_page's builder[].id) on a page — or a prefill via prefill_id. The new `block` must include `content_group` plus `base` + `content`. The block is replaced, not patched: the returned row id is NEW. Media a human assigned in the backend is carried over automatically wherever your payload leaves the field empty — unless you change content_group. Other blocks are untouched.",
         inputSchema: {
             type: "object",
             properties: {
-                page_id: { type: "integer" },
+                page_id: { type: "integer", description: "Page to edit. Pass exactly one of page_id / prefill_id." },
+                prefill_id: { type: "integer", description: "Prefill entry to edit instead of a page." },
                 block_id: { type: "integer" },
                 block: { type: "object" },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
-            required: ["page_id", "block_id", "block"],
+            required: ["block_id", "block"],
         },
     },
     {
         name: "remove_block",
-        description: "Remove a block by its row id from the page's builder.",
+        description: "Remove a block by its row id from a page's builder (or a prefill's via prefill_id). Remaining blocks keep their ids; ordering closes the gap.",
         inputSchema: {
             type: "object",
             properties: {
-                page_id: { type: "integer" },
+                page_id: { type: "integer", description: "Page to edit. Pass exactly one of page_id / prefill_id." },
+                prefill_id: { type: "integer", description: "Prefill entry to edit instead of a page." },
                 block_id: { type: "integer" },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
-            required: ["page_id", "block_id"],
+            required: ["block_id"],
         },
     },
     {
         name: "reorder_blocks",
-        description: "Reorder blocks. Send every block row id in the desired order (all existing block ids must be present, no extras).",
+        description: "Reorder blocks on a page (or a prefill via prefill_id). Send every block row id in the desired order (all existing block ids must be present, no extras).",
         inputSchema: {
             type: "object",
             properties: {
-                page_id: { type: "integer" },
+                page_id: { type: "integer", description: "Page to edit. Pass exactly one of page_id / prefill_id." },
+                prefill_id: { type: "integer", description: "Prefill entry to edit instead of a page." },
                 order: { type: "array", items: { type: "integer" } },
                 site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["order"],
+        },
+    },
+    {
+        name: "extract_block_to_prefill",
+        description: "Move an existing page block into a NEW Prefill entry and replace it in place with a `Prefill` reference block. Lossless — media a human assigned survives the move. Use this whenever a section should appear on more than one page: extract it once, then add_block a `Prefill` block ({content_group:'Prefill', content:{block:<prefill id>}}) on the other pages. This is the intended FrameworC workflow; never copy the same section onto multiple pages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page_id: { type: "integer" },
+                block_id: { type: "integer", description: "Row id of the block to extract." },
+                title: { type: "string", description: "Title for the new Prefill entry, e.g. 'Newsletter CTA'." },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
-            required: ["page_id", "order"],
+            required: ["page_id", "block_id", "title"],
         },
     },
     {
         name: "list_forms",
-        description: "List Form Tailor entries available for the `Form` block's `form_entry` argument.",
+        description: "List Form entries (id, title, slug, field_count, ...). Use get_form for a form's fields, create_form / update_form / delete_form for CRUD, and the id for the `Form` block's block-level `form` key.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+        },
+    },
+    {
+        name: "get_form_schema",
+        description: "Fetch the live field-group catalogue for Form entries from the CMS: every fwcFields group with its exact fields, enums and defaults, plus the form-level fields. Use before create_form / update_form when unsure of the shape.",
         inputSchema: {
             type: "object",
             properties: { site_url: { type: "string" } },
         },
     },
+    {
+        name: "get_form",
+        description: "Fetch one Form entry including its fwcFields rows (each {id, group, ...fields}).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "create_form",
+        description: "Create a Form entry. Payload: {form: {title (required), headline?, recipients?: [emails], is_enabled?}, fwcFields?: [rows]}. Each row names its `group` — one of: section, text, number, email, phone, textarea, file, select, checkbox, radio, agreement — plus that group's fields: input groups take {label, placeholder?, name (required, unique), fieldId?, required?, width?: full|half|third|twoThirds}; select/checkbox/radio add options: [{value, label}]; agreement adds text (rich HTML); section takes only content (rich HTML, not an input). Call get_form_schema when unsure of a group's exact fields. Reference the created form from a page with a `Form` block ({content_group:'Form', form:<id>, content:{variant:...}}).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                payload: {
+                    type: "object",
+                    properties: { form: { type: "object" }, fwcFields: { type: "array" } },
+                    required: ["form"],
+                },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["payload"],
+        },
+    },
+    {
+        name: "update_form",
+        description: "Update a Form entry. `form` merges scalar fields; if `fwcFields` is present the field rows are fully rebuilt from the array (send ALL rows, not a diff — they carry no media, so nothing is lost).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                payload: { type: "object", properties: { form: { type: "object" }, fwcFields: { type: "array" } } },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id", "payload"],
+        },
+    },
+    {
+        name: "delete_form",
+        description: "Delete a Form entry. Refused with a 422 naming the referencing pages if any `Form` block still points at it; pass force:true to delete anyway.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                force: { type: "boolean" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
+        },
+    },
     {
         name: "list_menus",
-        description: "List Menu Tailor entries available for the `MenuBlock`'s `content.menu_entry` argument.",
+        description: "List Menu entries (id, title, item_count, ...). Use get_menu / create_menu / update_menu / delete_menu for CRUD, and the id for `content.menu` on a MenuBlock or the `nav` field of the Navigation/Footer singles.",
         inputSchema: {
             type: "object",
-            properties: { site_url: { type: "string" } },
+            properties: {
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+        },
+    },
+    {
+        name: "get_menu",
+        description: "Fetch one Menu entry including its navigation tree (items {id, title, url, anchor, blank, children?}).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "create_menu",
+        description: "Create a Menu entry. Payload: {menu: {title (required)}, navigation?: [items]}. Each item: {title (required), url, anchor?, blank?, children?: [items]}. `url` is a string ('/', '/kontakt#form', full URL) OR {page_id: n} to link a FrameworC page robustly. Max 2 levels — children may not have children.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                payload: {
+                    type: "object",
+                    properties: { menu: { type: "object" }, navigation: { type: "array" } },
+                    required: ["menu"],
+                },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["payload"],
+        },
+    },
+    {
+        name: "update_menu",
+        description: "Update a Menu entry. `menu` merges title/slug/is_enabled; if `navigation` is present the whole tree is replaced from the array (send ALL items — they carry no media).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                payload: { type: "object", properties: { menu: { type: "object" }, navigation: { type: "array" } } },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id", "payload"],
+        },
+    },
+    {
+        name: "delete_menu",
+        description: "Delete a Menu entry. Refused with a 422 naming the referencing hosts (MenuBlocks, Navigation/Footer singles) if still referenced; pass force:true to delete anyway.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                force: { type: "boolean" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
         },
     },
     {
         name: "list_prefills",
-        description: "List Prefill Tailor entries available for the `Prefill` block's `content.prefill_entry` argument.",
+        description: "List Prefill entries (id, title, block_count, ...). Prefills hold sections shared across pages; reference one from a page with a `Prefill` block ({content_group:'Prefill', content:{block:<id>}}). Use get_prefill / create_prefill / update_prefill / delete_prefill for CRUD.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+        },
+    },
+    {
+        name: "get_prefill",
+        description: "Fetch one Prefill entry including its builder blocks — same block shape as get_page.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "create_prefill",
+        description: "Create a Prefill entry — a reusable section shared across pages. Payload: {prefill: {title (required), slug?}, builder?: [blocks]} with the SAME block shape as create_page. When several pages need the same section, create the Prefill FIRST and reference it from each page with a `Prefill` block instead of duplicating the section. (To factor out a section that already exists on a page, use extract_block_to_prefill instead.) Per-block edits work via add_block/update_block/remove_block/reorder_blocks with prefill_id.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                payload: {
+                    type: "object",
+                    properties: { prefill: { type: "object" }, builder: { type: "array" } },
+                    required: ["prefill"],
+                },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["payload"],
+        },
+    },
+    {
+        name: "update_prefill",
+        description: "Update a Prefill entry. `prefill` merges title/slug/is_enabled; a `builder` array fully rebuilds the blocks (prefer the per-block tools with prefill_id — a rebuild loses human-assigned media). Edits apply everywhere the prefill is referenced.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                payload: { type: "object", properties: { prefill: { type: "object" }, builder: { type: "array" } } },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id", "payload"],
+        },
+    },
+    {
+        name: "delete_prefill",
+        description: "Delete a Prefill entry. Refused with a 422 naming the referencing pages if any `Prefill` block still points at it; pass force:true to delete anyway (the referencing blocks would break).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                force: { type: "boolean" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "get_settings",
+        description: "Read the FrameworC plugin settings exposed over the API: navbar layout options and the custom SCSS variables. Settings are GLOBAL (not per multisite site). Integration/secret settings are not accessible by design.",
         inputSchema: {
             type: "object",
             properties: { site_url: { type: "string" } },
         },
     },
+    {
+        name: "update_settings",
+        description: "Update FrameworC plugin settings. `fields` is a partial map; writable keys: navigation_width (full|container), navigation_align (left|center|right), navigation_mobile_extra_links (navbar|open), variable_variablesScss (SCSS overriding the design tokens). Settings are GLOBAL and affect the whole install — confirm with the user first. Integration/secret settings cannot be read or written through this API by design.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fields: { type: "object", description: "Field name => value map (partial)." },
+                site_url: { type: "string" },
+            },
+            required: ["fields"],
+        },
+    },
     {
         name: "get_block_schema",
-        description: "Get the JSON schema + usage notes for a single block by content_group name. Use this when you need to recall field enums / required fields / conditional visibility for one block.",
+        description: "Get the JSON schema + usage notes for one block by content_group name. Fetched live from the CMS, which derives it from the actual Tailor blueprints, so it is always current. Use this to recall field enums, defaults and conditional visibility.",
         inputSchema: {
             type: "object",
             properties: {
                 name: { type: "string", enum: catalogue_js_1.BLOCKS.map((b) => b.content_group) },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
             },
             required: ["name"],
         },
     },
+    {
+        name: "get_page_meta",
+        description: "Read a per-site single: Meta (SEO defaults, blog base path), Navigation (navbar) or Footer. Use before composing pages so titles and descriptions match the site's conventions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                handle: { type: "string", enum: ["Meta", "Navigation", "Footer"] },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["handle"],
+        },
+    },
+    {
+        name: "update_page_meta",
+        description: "Update a per-site single (Meta / Navigation / Footer). Send only the fields you want to change, e.g. {handle:'Meta', fields:{metaTitle:'...', description:'...'}}. Media fields must be left empty. Affects every page on that site, so confirm with the user first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                handle: { type: "string", enum: ["Meta", "Navigation", "Footer"] },
+                fields: { type: "object", description: "Field name => value map." },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["handle", "fields"],
+        },
+    },
+    {
+        name: "create_translation",
+        description: "Create the sibling of an existing page — or Prefill entry, with prefill:true — on another multisite site, linked to the original so the language switcher connects them. Pass target_site_id, and optionally `page` (title/slug overrides) and `builder` (the translated blocks). Omitting builder copies nothing — the translation starts empty, ready for you to fill. Form and Menu entries have no translation linking; create them per site with site_id instead.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer", description: "Source page (or prefill) id." },
+                target_site_id: { type: "integer", description: "Site to create the translation on." },
+                source_site_id: { type: "integer", description: "Site the source record lives on. Defaults to the pinned CMS site." },
+                prefill: { type: "boolean", description: "Set true when id is a Prefill entry, not a page." },
+                page: { type: "object" },
+                builder: { type: "array" },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["id", "target_site_id"],
+        },
+    },
 ];
-const server = new index_js_1.Server({ name: "frameworc-mcp", version: "0.2.0" }, { capabilities: { tools: {}, resources: {} } });
+const server = new index_js_1.Server({ name: "frameworc-mcp", version: "0.4.0" }, { capabilities: { tools: {}, resources: {} } });
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
     tools,
 }));
@@ -200,6 +518,10 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
     const name = req.params.name;
     const args = (req.params.arguments ?? {});
     (0, sites_js_1.refreshIfChanged)();
+    // A one-off site_id argument overrides the pinned CMS site for this call.
+    const site = args.site_id !== undefined && args.site_id !== null
+        ? Number(args.site_id)
+        : undefined;
     if (name !== "use_site" && name !== "list_sites" && !args.site_url && !session.getUrl()) {
         return {
             content: [
@@ -254,68 +576,176 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
                     content: [{ type: "text", text: JSON.stringify({ sites }, null, 2) }],
                 };
             }
+            case "list_cms_sites": {
+                const r = await client.listCmsSites();
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "use_cms_site": {
+                const id = args.site_id === null || args.site_id === undefined ? null : Number(args.site_id);
+                session.setSiteId(id);
+                return {
+                    content: [{
+                            type: "text",
+                            text: id === null
+                                ? "Using the primary CMS site."
+                                : `Using CMS site id ${id} for subsequent calls.`,
+                        }],
+                };
+            }
             case "list_pages": {
-                const r = await client.listPages();
+                const r = await client.listPages(site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "get_page": {
-                const r = await client.getPage(Number(args.id));
+                const r = await client.getPage(Number(args.id), site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "create_page": {
-                const r = await client.createPage(args.payload);
+                const r = await client.createPage(args.payload, site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "update_page": {
-                const r = await client.updatePage(Number(args.id), args.payload);
+                const r = await client.updatePage(Number(args.id), args.payload, site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "delete_page": {
-                const r = await client.deletePage(Number(args.id));
+                const r = await client.deletePage(Number(args.id), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "create_translation": {
+                const payload = { page: args.page ?? {}, builder: args.builder };
+                const source = args.source_site_id !== undefined ? Number(args.source_site_id) : undefined;
+                const r = args.prefill
+                    ? await client.createPrefillTranslation(Number(args.id), Number(args.target_site_id), { prefill: args.page ?? {}, builder: args.builder }, source)
+                    : await client.createTranslation(Number(args.id), Number(args.target_site_id), payload, source);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "add_block": {
-                const r = await client.addBlock(Number(args.page_id), args.block, args.position !== undefined ? Number(args.position) : undefined);
+                const r = await client.addBlock(blockHost(args), args.block, args.position !== undefined ? Number(args.position) : undefined, site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "update_block": {
-                const r = await client.updateBlock(Number(args.page_id), Number(args.block_id), args.block);
+                const r = await client.updateBlock(blockHost(args), Number(args.block_id), args.block, site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "remove_block": {
-                const r = await client.removeBlock(Number(args.page_id), Number(args.block_id));
+                const r = await client.removeBlock(blockHost(args), Number(args.block_id), site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "reorder_blocks": {
-                const r = await client.reorderBlocks(Number(args.page_id), args.order);
+                const r = await client.reorderBlocks(blockHost(args), args.order, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "extract_block_to_prefill": {
+                const r = await client.extractBlockToPrefill(Number(args.page_id), Number(args.block_id), args.title ?? "", site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "list_forms": {
-                const r = await client.listForms();
+                const r = await client.listForms(site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_form_schema": {
+                const r = await client.getFormSchema();
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_form": {
+                const r = await client.getForm(Number(args.id), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "create_form": {
+                const r = await client.createForm(args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_form": {
+                const r = await client.updateForm(Number(args.id), args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "delete_form": {
+                const r = await client.deleteForm(Number(args.id), Boolean(args.force), site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "list_menus": {
-                const r = await client.listMenus();
+                const r = await client.listMenus(site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_menu": {
+                const r = await client.getMenu(Number(args.id), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "create_menu": {
+                const r = await client.createMenu(args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_menu": {
+                const r = await client.updateMenu(Number(args.id), args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "delete_menu": {
+                const r = await client.deleteMenu(Number(args.id), Boolean(args.force), site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "list_prefills": {
-                const r = await client.listPrefills();
+                const r = await client.listPrefills(site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_prefill": {
+                const r = await client.getPrefill(Number(args.id), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "create_prefill": {
+                const r = await client.createPrefill(args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_prefill": {
+                const r = await client.updatePrefill(Number(args.id), args.payload, site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "delete_prefill": {
+                const r = await client.deletePrefill(Number(args.id), Boolean(args.force), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_settings": {
+                const r = await client.getSettings();
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_settings": {
+                const r = await client.updateSettings(args.fields ?? {});
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "get_page_meta": {
+                const r = await client.getSingle(String(args.handle), site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_page_meta": {
+                const r = await client.updateSingle(String(args.handle), args.fields ?? {}, site);
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
             case "get_block_schema": {
-                const block = catalogue_js_1.BLOCKS.find((b) => b.content_group === args.name);
-                if (!block) {
+                // Served by the CMS so it always matches the live blueprints; the
+                // bundled catalogue is only a fallback for an older plugin version.
+                try {
+                    const r = await client.getBlockSchema(String(args.name));
+                    return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+                }
+                catch (err) {
+                    const block = catalogue_js_1.BLOCKS.find((b) => b.content_group === args.name);
+                    if (!block) {
+                        return {
+                            content: [{
+                                    type: "text",
+                                    text: `Unknown block "${args.name}". Available: ${catalogue_js_1.BLOCKS.map((b) => b.content_group).join(", ")}`,
+                                }],
+                            isError: true,
+                        };
+                    }
                     return {
-                        content: [
-                            {
+                        content: [{
                                 type: "text",
-                                text: `Unknown block "${args.name}". Available: ${catalogue_js_1.BLOCKS.map((b) => b.content_group).join(", ")}`,
-                            },
-                        ],
-                        isError: true,
+                                text: `(served from the bundled catalogue; live schema unavailable: ${err?.message ?? err})\n`
+                                    + JSON.stringify(block, null, 2),
+                            }],
                     };
                 }
-                return { content: [{ type: "text", text: JSON.stringify(block, null, 2) }] };
             }
             default: {
                 return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };