@typeroll/mcp-server 0.7.4 → 0.7.5

package/dist/tools/pages.js

@@ -7,11 +7,12 @@ function v(version) {
 export const pageTools = [
     {
         name: 'list_pages',
-        description: 'List pages on the active site. Returns id, title, slug, status, and SEO summary. Supports filtering by status and forward-cursor pagination.',
+        description: 'List pages on the active site. Returns id, title, slug, status, and SEO summary (no html_content by default — use read_page or batch_read_pages for body content). Supports filtering by status and forward-cursor pagination. Pass full=true to include html_content + blocks in the response.',
         inputSchema: {
             status: z.enum(['draft', 'review', 'unlisted', 'published', 'all']).optional(),
             limit: z.number().int().min(1).max(200).optional(),
             cursor: z.string().optional(),
+            full: z.boolean().optional().describe('Set true to include html_content + blocks. Default false (summary only) to avoid large payloads on sites with many pages.'),
             version: versionParam,
         },
         handler: withErrorBoundary(async (args, { client, siteId }) => {
@@ -19,6 +20,7 @@ export const pageTools = [
                 status: args.status,
                 limit: args.limit,
                 cursor: args.cursor,
+                full: args.full ? 'true' : undefined,
                 ...v(args.version),
             });
             return ok(res);
@@ -50,11 +52,16 @@ export const pageTools = [
     },
     {
         name: 'create_page',
-        description: 'Create a new page. Defaults to blocks-mode (recommended) — the new page seeds with a heading + prose block built from the title. Pass content_mode="html" to opt out. Slug is derived from title when omitted; default status is "draft". Returns the created page.',
+        description: 'Create a new page. Defaults to html mode — pass html_content to set the body. ' +
+            'Slug is derived from the title when omitted. Default status is "draft". ' +
+            'Homepage convention: pass slug="" (empty string) or omit slug and set title to "Home"; ' +
+            'the server stores it under id "home" with slug "". ' +
+            'Do NOT pass slug="/"; strip leading slashes from slugs (use "about", not "/about"). ' +
+            'Returns the created page including html_content.',
         inputSchema: {
             title: z.string().min(1),
-            slug: z.string().optional(),
-            content_mode: z.enum(['blocks', 'html']).optional().describe('Default "blocks". "html" stores body in html_content; "blocks" stores a Block[] tree.'),
+            slug: z.string().optional().describe('URL slug without leading slash (e.g. "about", "services/design"). Empty string "" = homepage.'),
+            content_mode: z.enum(['blocks', 'html']).optional().describe('Default "html". "html" stores body in html_content; "blocks" stores a Block[] tree (note: blocks mode pages render as empty until the block editor ships — use html mode for all real content).'),
             html_content: z.string().optional().describe('Body HTML — only used when content_mode="html".'),
             blocks: z.array(z.any()).optional().describe('Block tree — only used when content_mode="blocks". Omit to get the default heading+prose seed.'),
             status: z.enum(['draft', 'review', 'unlisted', 'published']).optional(),

package/dist/tools/settings.js

@@ -18,7 +18,12 @@ export const settingsTools = [
     },
     {
         name: 'update_site_settings',
-        description: 'Patch site settings. Only the fields you pass change. Nested objects (colors, fonts, contact, social) are shallow-merged. scripts_head / scripts_body_end / custom_css ARE writable here — useful for a global stylesheet across all pages. Whatever you ship in those fields runs verbatim on the rendered site, so treat them as code, not data.',
+        description: 'Patch site settings. Only the fields you pass change. ' +
+            'Pass fields at the TOP LEVEL of the object — do NOT wrap in a "settings" key. ' +
+            'Example: {"site_name": "Acme", "colors": {"primary": "#ff0"}} not {"settings": {...}}. ' +
+            'Nested objects (colors, fonts, contact, social) are shallow-merged into the existing value. ' +
+            'Unknown top-level keys return a 400 error listing the valid fields. ' +
+            'scripts_head / scripts_body_end / custom_css ARE writable here — useful for a global stylesheet across all pages.',
         inputSchema: {
             site_name: z.string().optional(),
             tagline: z.string().optional(),

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@typeroll/mcp-server",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "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": {
     "type": "git",
-    "url": "https://github.com/bootingbots/typeroll.git",
+    "url": "git+https://github.com/bootingbots/typeroll.git",
     "directory": "packages/mcp-server"
   },
   "homepage": "https://github.com/bootingbots/typeroll/tree/main/packages/mcp-server#readme",
   "bugs": "https://github.com/bootingbots/typeroll/issues",
   "type": "module",
   "bin": {
-    "typeroll-mcp": "./dist/index.js"
+    "typeroll-mcp": "dist/index.js"
   },
   "main": "./dist/index.js",
   "files": [