frameworc-mcp 0.5.1 → 0.6.1

package/README.md

@@ -9,7 +9,7 @@ A [Model Context Protocol](https://modelcontextprotocol.io) server that lets Cla
 - Creates pages, adds / updates / removes / reorders individual blocks — on pages and on Prefill entries
 - Full CRUD for `Form` entries (incl. their field rows), `Menu` entries (incl. the navigation tree) and `Prefill` entries (incl. their builder blocks)
 - Extracts a repeated page section into a Prefill entry and replaces it with a reference (`extract_block_to_prefill`) — the intended FrameworC de-duplication workflow
-- Reads and writes the per-site singles (Meta & SEO, Navigation, Footer) and the global FrameworC settings (navbar options, SCSS variables; integration secrets are not accessible by design)
+- Reads and writes the per-site singles (Meta & SEO, Navigation, Footer) and the FrameworC settings (global navbar options and SCSS, per-site SCSS; integration secrets are not accessible by design)
 - Multisite-aware: every content tool takes/pins a `site_id`; page and prefill translations are linked for the language switcher
 - Publishes the block catalogue as an MCP resource (`frameworc://blocks`) so the chat agent knows each block's fields, defaults, and when-to-use notes
 - Draft by default — created pages have `is_enabled = false`; the human flips the switch in the OctCMS backend after assigning images
@@ -96,7 +96,7 @@ If the file is missing or empty, `use_site` errors with a pointer to where to ad
 
 ### Adding a new OctCMS site
 
-1. Spin up the new OctCMS install with the FrameworC suite incl. the `crscompany/frameworcmcp` plugin (v1.2.0 or newer; media assignment needs v1.2.0).
+1. Spin up the new OctCMS install with the FrameworC suite incl. the `crscompany/frameworcmcp` plugin (v1.3.0 or newer; media assignment needs v1.2.0, per-site settings need v1.3.0 with FrameworC v1.10.0).
 2. Backend → Settings → FrameworC → **MCP API** → paste a freshly generated random string (e.g. `openssl rand -hex 32`) → Save.
 3. Edit `~/.config/frameworc/sites.json` on your laptop, add one entry: `{ "label": "New Client", "url": "https://newsite.test", "token": "<that string>" }`.
 4. In your next chat (no Claude Desktop restart needed): *"Use `https://newsite.test`."* → MCP hot-reloads the file, finds the token, sends it. Done.
@@ -136,7 +136,8 @@ No env var, no chat-client config edit, no ToolHive touch, no repo push. The who
 | `list_prefills` / `get_prefill(id)` | Prefill entries; `get_prefill` includes the builder blocks. |
 | `create_prefill` / `update_prefill` / `delete_prefill` | Prefill CRUD — same block shape as pages; delete guarded. |
 | `get_page_meta(handle)` / `update_page_meta(handle, fields)` | Per-site singles: `Meta` (SEO), `Navigation` (navbar incl. `nav` menu link + buttons), `Footer` (incl. `socials` rows + `nav`). |
-| `get_settings` / `update_settings(fields)` | Global FrameworC settings: navbar options + custom SCSS variables. Integration secrets are not exposed. |
+| `get_settings` / `update_settings(fields)` | Global FrameworC settings: navbar options + global custom SCSS (`styles_globalScss`). Integration secrets are not exposed. |
+| `get_site_settings` / `update_site_settings(fields)` | Per-site FrameworC settings: custom SCSS for one site (`siteScss`), compiled after the global SCSS. |
 | `get_block_schema(name)` | Field schema + usage notes for one block (live from the CMS). |
 | `list_media(folder?, type?, sort?, limit?, offset?)` | Browse the media library. Returns files with their `path` — write that into a mediafinder field. |
 | `search_media(q, folder?, type?, ...)` | Find library files by name across all folders. Every whitespace-separated word must appear in the path. |

package/dist/api-client.js

@@ -199,6 +199,13 @@ class ApiClient {
     updateSettings(fields) {
         return this.request("/settings", { method: "PATCH", body: JSON.stringify({ fields }) });
     }
+    // --- FrameworC settings (per site) -------------------------------------
+    getSiteSettings(siteId) {
+        return this.request(this.q("/site-settings", siteId));
+    }
+    updateSiteSettings(fields, siteId) {
+        return this.request("/site-settings", { method: "PATCH", body: this.b({ fields }, siteId) });
+    }
     // --- singles ----------------------------------------------------------
     getSingle(handle, siteId) {
         return this.request(this.q(`/singles/${encodeURIComponent(handle)}`, siteId));

package/dist/catalogue.js

@@ -42,7 +42,7 @@ const baseBlock = [
     { name: "responsiveHide", type: "checkboxlist", enum: ["desktop", "tablet", "mobile"], comment: "Which devices to hide this block on." },
 ];
 const sectionVariants = [
-    "halfAndHalf", "noText", "noImage", "textAndText", "img70", "text70",
+    "halfAndHalf", "imgBleed", "noText", "noImage", "textAndText", "img70", "text70",
     "embedHalfAndHalf", "embed70", "embed30", "embedOnly",
 ];
 exports.BLOCKS = [
@@ -56,6 +56,8 @@ exports.BLOCKS = [
             { name: "image", type: "media-single", comment: "Media library path. Declared mode:image, but an .mp4 is valid here when isVideoBg is on." },
             { name: "imageMobile", type: "media-single" },
             { name: "isVideoBg", type: "switch", default: false, comment: "If true, 'image' is treated as a video file and 'imageMobile' as poster." },
+            { name: "fullVideo", type: "media-single", comment: "Only used when isVideoBg is on. Media library path to the full-length video; a play button opens it in a lightbox popup over the page." },
+            { name: "fullVideoLabel", type: "text", comment: "Only used when isVideoBg is on. Label of the button that opens fullVideo." },
             ...buttonsMixin,
             { name: "fullHeight", type: "switch", default: true },
             { name: "contrast", type: "switch", default: false, comment: "Use contrast (light-on-dark) text for the headline when the background image is dark." },
@@ -66,11 +68,12 @@ exports.BLOCKS = [
         content_group: "Section",
         name: "Section",
         description: "Text + image / embed in a configurable column layout. The most common content block.",
-        whenToUse: "Default choice for any paragraph + image content. Pick a variant that matches the proportion of text to visual. Use 'textAndText' for two text columns (e.g. a feature comparison). Use an 'embed*' variant when you have a YouTube video, map iframe, etc.",
+        whenToUse: "Default choice for any paragraph + image content. Pick a variant that matches the proportion of text to visual. Use 'imgBleed' for an image running to the edge of the viewport next to half-width text. Use 'textAndText' for two text columns (e.g. a feature comparison). Use an 'embed*' variant when you have a YouTube video, map iframe, etc.",
         base: baseBlock,
         content: [
             { name: "variant", type: "dropdown", enum: sectionVariants, default: "halfAndHalf" },
             { name: "reverse", type: "switch", default: false, hiddenWhen: { field: "variant", equals: ["noText", "noImage", "embedOnly"] }, comment: "Swap sides (image left vs right)." },
+            { name: "reverseMobile", type: "switch", default: false, hiddenWhen: { field: "variant", equals: ["noText", "noImage", "embedOnly"] }, comment: "On mobile the columns stack; this flips their stacking order." },
             { name: "image", type: "media-multi", comment: "Stored as an ARRAY of paths (the blueprint sets no maxItems) but the theme renders only the FIRST item, so send [\"/photo.jpg\"].", hiddenWhen: { field: "variant", equals: ["noImage", "embedHalfAndHalf", "embedOnly", "embed30", "embed70", "textAndText"] } },
             { name: "embed", type: "codeeditor", shownWhen: { field: "variant", equals: ["embedHalfAndHalf", "embedOnly", "embed30", "embed70"] }, comment: "Raw embed HTML (iframe etc.)." },
             ...buttonsMixin,

package/dist/index.js

@@ -433,7 +433,7 @@ const tools = [
     },
     {
         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.",
+        description: "Read the FrameworC plugin settings exposed over the API: navbar layout options and the global custom SCSS. Settings are GLOBAL (not per multisite site); per-site SCSS lives in get_site_settings. Integration/secret settings are not accessible by design.",
         inputSchema: {
             type: "object",
             properties: { site_url: { type: "string" } },
@@ -441,7 +441,7 @@ const tools = [
     },
     {
         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.",
+        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), styles_globalScss (SCSS compiled into every site before that site's own SCSS, so its $variables and mixins are usable there; SCSS that does not compile is rejected). 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: {
@@ -451,6 +451,30 @@ const tools = [
             required: ["fields"],
         },
     },
+    {
+        name: "get_site_settings",
+        description: "Read the per-site FrameworC settings: siteScss, the custom SCSS for one multisite site. It is compiled after the global styles_globalScss from get_settings, so it can use that SCSS's $variables and mixins.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+        },
+    },
+    {
+        name: "update_site_settings",
+        description: "Update the per-site FrameworC settings. `fields` is a partial map; writable key: siteScss (SCSS for this site only, compiled after the global SCSS; SCSS that does not compile is rejected). Affects every page on that site, so confirm with the user first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                fields: { type: "object", description: "Field name => value map (partial)." },
+                site_url: { type: "string" },
+                site_id: { type: "integer", description: "Target multisite site id; defaults to the pinned CMS site." },
+            },
+            required: ["fields"],
+        },
+    },
     {
         name: "list_media",
         description: "Browse the media library one folder at a time. Returns {folder, parent, folders:[{path,name,item_count}], files:[{path,name,file_type,extension,size,last_modified,url}], total_files, truncated}. To put a file on a page, write its `path` — the root-relative form with a leading slash, e.g. \"/logos/brand.svg\" — into a mediafinder field; never the `url`. This server CANNOT upload: if the file the user wants is not here, say so and ask them to add it in Backend > Media. Prefer search_media when you know part of the name. Note that `file_type` buckets follow the install's media config (SVG may report as image or as document), so treat `type` as a convenience filter rather than a guarantee. The library is global: site_id is accepted and ignored.",
@@ -770,6 +794,14 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
                 const r = await client.updateSettings(args.fields ?? {});
                 return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
             }
+            case "get_site_settings": {
+                const r = await client.getSiteSettings(site);
+                return { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] };
+            }
+            case "update_site_settings": {
+                const r = await client.updateSiteSettings(args.fields ?? {}, site);
+                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) }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frameworc-mcp",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "MCP server for the FrameworC OctoberCMS plugin — programmatically create/edit FrameworC pages and blocks.",
   "license": "MIT",
   "type": "commonjs",