@typeroll/mcp-server 0.9.0 → 0.10.0

package/AGENTS.md

@@ -305,6 +305,32 @@ read_page page_id=...
 update_page page_id=... patch={ html_content: "<...><img src='{cdn_url}' alt='…' /></...>" }
 ```
 
+### "Stop an image over-fetching a too-large variant"
+
+When an image renders much narrower than the viewport (a container-constrained
+hero, a sidebar thumbnail), the default `<picture sizes>` of
+`(max-width: 768px) 100vw, 800px` makes the browser pull a wider srcset variant
+than it needs — Lighthouse flags it as wasted bytes. Three levers, narrowest
+wins:
+
+```
+# 1. Per-image: put a real `sizes` on the <img>. Survives the transform verbatim.
+update_page page_id=... patch={ html_content:
+  "<img src='{cdn_url}' alt='…' sizes='(max-width: 640px) 360px, 560px' />" }
+
+# 2. Per-page default (applies to every image on the page that has no own sizes):
+update_page page_id=... patch={ image_sizes_default: "(max-width: 640px) 360px, 560px" }
+
+# 3. Site-wide default (fallback under the page default):
+update_site_settings image_sizes_default="(max-width: 640px) 360px, 560px"
+```
+
+Precedence: per-image `sizes` > page `image_sizes_default` >
+site `image_sizes_default` > the generic built-in. To opt a single image out of
+the platform's auto-`<picture>` entirely, hand-write your own `<picture>` with
+custom `<source media=…>` — the transform leaves an existing `<picture>`
+untouched (it no longer re-wraps the inner `<img>`).
+
 ### "Fill missing alt-text across the media library"
 
 ```

package/dist/tools/pages.js

@@ -90,6 +90,7 @@ export const pageTools = [
             author: z.string().optional(),
             language: z.string().optional().describe('BCP-47 tag overriding the site default (e.g. "en" on an otherwise Swedish site).'),
             template: z.string().optional().describe('Page template id (PageTemplate). Wraps the body in the template tree at render time.'),
+            image_sizes_default: z.string().optional().describe('Per-page default `sizes` for responsive images (e.g. "(max-width: 640px) 360px, 560px"). Overrides the site setting; a per-<img> `sizes` attr still wins. Set when this page\'s images render narrower than the generic default so the browser stops over-fetching.'),
             version: versionParam,
         },
         handler: withErrorBoundary(async (args, { client, siteId }) => {
@@ -121,6 +122,7 @@ export const pageTools = [
                 canonical_url: z.string().optional(),
                 noindex: z.boolean().optional(),
                 lastmod_override: z.string().optional().describe('Override the sitemap <lastmod>. Empty string suppresses lastmod for this page entirely.'),
+                image_sizes_default: z.string().optional().describe('Per-page default `sizes` for responsive images (e.g. "(max-width: 640px) 360px, 560px"). Overrides the site setting; a per-<img> `sizes` attr still wins. Set when this page\'s images render narrower than the generic default so the browser stops over-fetching the larger variant.'),
                 json_ld: z.string().optional(),
                 schema_type: z.string().optional().describe('Free-form Schema.org type ("Service", "Course", "Product", …) used for auto JSON-LD emission. Use service.* for Service-specific fields.'),
                 service: z

package/dist/tools/settings.js

@@ -10,7 +10,7 @@ import { ok, withErrorBoundary } from './helpers.js';
 export const settingsTools = [
     {
         name: 'read_site_settings',
-        description: "Read every site setting: name, tagline, logo, favicon, colors, fonts, contact info, social links, default SEO suffix, language, robots_txt, plus the scriptable surfaces scripts_head, scripts_body_end, and custom_css.",
+        description: "Read every site setting: name, tagline, logo, favicon, colors, fonts, contact info, social links, default SEO suffix, language, robots_txt, image_sizes_default, plus the scriptable surfaces scripts_head, scripts_body_end, and custom_css.",
         handler: withErrorBoundary(async (_args, { client, siteId }) => {
             const res = await client.get(siteId, 'settings');
             return ok(res);
@@ -32,6 +32,7 @@ export const settingsTools = [
             default_seo_suffix: z.string().optional(),
             language: z.string().optional().describe('BCP-47 tag (e.g. "en", "sv", "en-GB"). Drives <html lang> on the rendered site.'),
             robots_txt: z.string().optional(),
+            image_sizes_default: z.string().optional().describe('Site-wide default `sizes` attribute for responsive-image <picture> output, e.g. "(max-width: 640px) 360px, 560px". Tells the browser how wide images actually render so it stops over-fetching the larger srcset variant. A page can override via its own image_sizes_default; a per-<img> `sizes` attribute wins over both. Leave unset for the generic "(max-width: 768px) 100vw, 800px".'),
             // Scriptable surfaces. Trusted because the caller has an API key.
             scripts_head: z.string().optional().describe('Raw HTML injected into <head> on every page. Use for analytics, fonts, third-party CSS links.'),
             scripts_body_end: z.string().optional().describe('Raw HTML injected just before </body> on every page. Use for chat widgets, deferred analytics.'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeroll/mcp-server",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Model Context Protocol server for the Typeroll public API. Use with Claude Code or any MCP-compatible client to manage a Typeroll site.",
   "license": "MIT",
   "repository": {