@bettercms-ai/mcp 0.9.0 → 0.11.0

package/SKILL.md

@@ -58,6 +58,24 @@ Tools: `list_components`, `get_component`, `create_component`, `update_component
 Authoring `blockJson` blind is error-prone — keep trees small, confirm with the user,
 and read back with `get_component` to verify.
 
+## AI content & SEO
+Tools: `write_content`, `generate_seo_meta`. Guided prompts: `build_site`,
+`generate_landing_pages`, `seo_optimize`. These use the workspace's own Anthropic key
+(BYOK, unmetered) or platform AI credits, and return a *suggestion* — you apply it.
+
+1. **Write copy** → `write_content { action, text, instructions?, targetLang?, context? }`.
+   `action`: `write` (draft from a brief), `rewrite` (improve existing copy), `translate`
+   (needs `targetLang`). Returns the text — apply it with `set_page_content`, `create_entry`,
+   or `update_entry`.
+2. **SEO meta** → `generate_seo_meta { text, context? }` returns
+   `{ metaTitle, metaDescription, keywords, jsonLd? }`. Read the page/entry, pass its content
+   as `text`, then apply the suggestion via the page/entry update tools.
+3. **Programmatic pages** → for a template + a dataset, loop rows: `write_content` per slot →
+   `create_entry` → `generate_seo_meta`. Confirm the first row or two first. For hundreds of
+   rows, the dashboard AI Page Builder bulk-imports a CSV.
+
+Always show suggestions to the user before applying; never invent brand facts.
+
 ## Errors
 - `401/403` → the MCP key needs (re)authorizing (re-run "Connect your AI").
 - `409 slug_taken` → offer a different slug.

package/dist/index.js

@@ -438,6 +438,25 @@ function buildToolDefs(deps) {
     metaTitle: z.string().optional().describe("SEO meta title"),
     metaDescription: z.string().optional().describe("SEO meta description")
   });
+  const writeContentInput = z.object({
+    action: z.enum(["write", "rewrite", "translate"]).describe("'write' = draft from a brief, 'rewrite' = improve existing copy, 'translate' = needs targetLang"),
+    text: z.string().min(1).describe("the source text (a brief for 'write', the copy to change otherwise)"),
+    instructions: z.string().optional().describe("optional extra guidance, e.g. 'make it punchier'"),
+    targetLang: z.string().optional().describe("required for 'translate', e.g. 'Spanish'"),
+    context: z.string().optional().describe("optional surrounding context, e.g. the page title")
+  });
+  const generateSeoMetaInput = z.object({
+    text: z.string().min(1).describe("the content to derive SEO metadata from"),
+    context: z.string().optional().describe("optional surrounding context, e.g. the page slug")
+  });
+  const createModelInput = z.object({
+    name: z.string().min(1).describe("human model name, e.g. 'Blog Post'"),
+    slug: slug.describe("url-safe unique slug, e.g. 'blog-post'"),
+    description: z.string().optional(),
+    fields: z.array(fieldObject).optional().describe(
+      "the model's typed schema fields. 'group'/'repeater' NEST their child fields (any depth) \u2014 don't flatten zones into top-level fields."
+    )
+  });
   const addFieldInput = z.object({
     modelId: z.string().min(1).describe("id of the content model to extend"),
     ...fieldShape
@@ -488,7 +507,7 @@ function buildToolDefs(deps) {
     pageId: z.string().min(1).describe("id of the page to delete (from list_pages)")
   });
   const deleteEntryInput = z.object({
-    entryId: z.string().min(1).describe("id of the content entry to delete (from list_entries)")
+    entryId: z.string().min(1).describe("id of the content entry to delete (from list_content_entries)")
   });
   const deleteModelInput = z.object({
     modelId: z.string().min(1).describe("id of the content model to delete (from list_content_models)")
@@ -578,6 +597,266 @@ function buildToolDefs(deps) {
   const getComponentInput = z.object({
     componentId: z.string().min(1).describe("component id (from list_components)")
   });
+  function lifecycleTools() {
+    const def = (name, title, description, shape, run) => ({
+      name,
+      config: { title, description, inputSchema: shape },
+      handler: guard(async (args) => withClient((client) => run(client, args)))
+    });
+    const q = (obj) => {
+      const p = new URLSearchParams();
+      for (const [k, v] of Object.entries(obj)) if (v !== void 0 && v !== null) p.set(k, String(v));
+      const s2 = p.toString();
+      return s2 ? `?${s2}` : "";
+    };
+    const data = async (client, method, path, body) => (await client.fetchJSON(client.url(path), {
+      method,
+      ...body !== void 0 ? { body: JSON.stringify(body), headers: { "content-type": "application/json" } } : {}
+    })).data;
+    const s = (v) => v;
+    const raw = async (client, path, base64, mimeType) => (await client.fetchJSON(client.url(path), {
+      method: "POST",
+      body: Buffer.from(base64, "base64"),
+      headers: { "content-type": mimeType ?? "application/octet-stream" }
+    })).data;
+    return [
+      def(
+        "list_media",
+        "List media assets",
+        "List the images/assets already in the connected project's Media Library (id, url, filename, mimeType, size, alt/caption). Reuse an existing asset instead of re-uploading. Filter with `search` or `type` ('image'|'video'|\u2026).",
+        z.object({ search: z.string().optional(), type: z.string().optional(), limit: z.number().optional(), page: z.number().optional() }).shape,
+        async (c, a) => ok("Media assets.", await data(c, "GET", `/management/media${q({ search: a.search, type: a.type, limit: a.limit, page: a.page })}`))
+      ),
+      def(
+        "get_media",
+        "Get a media asset",
+        "Get one media asset by id \u2014 its CDN url, filename, MIME type, size, and alt/caption. Use the url as the value of an 'image' field.",
+        z.object({ assetId: z.string().min(1).describe("media asset id (from list_media / upload_asset)") }).shape,
+        async (c, a) => ok("Media asset.", await data(c, "GET", `/management/media/${s(a.assetId)}`))
+      ),
+      def(
+        "delete_media",
+        "Delete a media asset",
+        "Delete a media asset from the Media Library (soft delete \u2014 reversible from the dashboard trash). Provide assetId.",
+        z.object({ assetId: z.string().min(1).describe("media asset id (from list_media)") }).shape,
+        async (c, a) => ok("Deleted media asset.", await data(c, "DELETE", `/management/media/${s(a.assetId)}`))
+      ),
+      def(
+        "delete_form",
+        "Delete a form",
+        "Delete a form by id. Soft delete \u2014 the form stops rendering and accepting submissions, but leads already collected against it are preserved. Use it to clean up forms created by mistake.",
+        z.object({ formId: z.string().min(1).describe("form id (from list_forms)") }).shape,
+        async (c, a) => ok("Deleted form.", await data(c, "DELETE", `/management/forms/${s(a.formId)}`))
+      ),
+      def(
+        "list_form_submissions",
+        "List a form's submissions (leads)",
+        "List the SUBMISSIONS (leads) a form has received \u2014 each with its submitted field values. Filter with status ('inbox'|'spam') and paginate with limit/page.",
+        z.object({ formId: z.string().min(1), status: z.enum(["inbox", "spam"]).optional(), limit: z.number().optional(), page: z.number().optional() }).shape,
+        async (c, a) => ok("Form submissions.", await data(c, "GET", `/management/forms/${s(a.formId)}/submissions${q({ status: a.status, limit: a.limit, page: a.page })}`))
+      ),
+      def(
+        "delete_form_submission",
+        "Delete a form submission",
+        "Delete one form submission (lead) \u2014 e.g. to clear spam. Provide formId and submissionId (from list_form_submissions).",
+        z.object({ formId: z.string().min(1), submissionId: z.string().min(1) }).shape,
+        async (c, a) => ok("Deleted submission.", await data(c, "DELETE", `/management/forms/${s(a.formId)}/submissions/${s(a.submissionId)}`))
+      ),
+      def(
+        "list_redirects",
+        "List redirects",
+        "List the URL redirects configured for the connected project (source path \u2192 destination, type).",
+        z.object({}).shape,
+        async (c) => ok("Redirects.", await data(c, "GET", `/management/redirects`))
+      ),
+      def(
+        "update_redirect",
+        "Update a redirect",
+        "Update an existing redirect in place \u2014 change where it points, its HTTP status, or disable it without deleting. Prefer this over delete+create: it keeps the redirect's id and preserves the chain-collapse rewrites of other rules pointing at it. Only provided fields change. Loops 422, duplicate sources 409.",
+        z.object({ redirectId: z.string().min(1).describe("redirect id (from list_redirects)"), sourcePath: z.string().min(1).optional(), destination: z.string().min(1).optional(), redirectType: z.enum(["301", "302", "307", "308"]).optional(), isActive: z.boolean().optional().describe("set false to disable without deleting") }).shape,
+        async (c, a) => ok("Updated redirect.", await data(c, "PATCH", `/management/redirects/${s(a.redirectId)}`, { sourcePath: a.sourcePath, destination: a.destination, redirectType: a.redirectType, isActive: a.isActive }))
+      ),
+      def(
+        "create_redirect",
+        "Create a redirect",
+        "Create a URL redirect \u2014 e.g. a 301 after renaming a page's slug. `sourcePath` is the path to redirect FROM ('/old-page'), `destination` the path/url TO ('/new-page'). Chains collapse; loops/dupes rejected. Defaults to 301.",
+        z.object({ sourcePath: z.string().min(1), destination: z.string().min(1), redirectType: z.enum(["301", "302", "307", "308"]).optional() }).shape,
+        async (c, a) => ok("Created redirect.", await data(c, "POST", `/management/redirects`, { sourcePath: a.sourcePath, destination: a.destination, redirectType: a.redirectType }))
+      ),
+      def(
+        "delete_redirect",
+        "Delete a redirect",
+        "Delete a URL redirect by id (from list_redirects). Provide redirectId.",
+        z.object({ redirectId: z.string().min(1) }).shape,
+        async (c, a) => ok("Deleted redirect.", await data(c, "DELETE", `/management/redirects/${s(a.redirectId)}`))
+      ),
+      def(
+        "get_seo",
+        "Get site SEO",
+        "Get the connected project's site-wide SEO settings \u2014 default meta (title/description/ogImage), JSON-LD siteSchema, and robots/sitemap/rss config.",
+        z.object({}).shape,
+        async (c) => ok("SEO settings.", await data(c, "GET", `/management/seo`))
+      ),
+      def(
+        "update_seo",
+        "Update site SEO",
+        "Set site-wide SEO defaults. `seoDefaults` { metaTitle, metaDescription, ogImage, twitterHandle } applies to every page unless overridden. Optionally robotsConfig / sitemapConfig / rssConfig. Each field is REPLACED whole. Rebuilds the site.",
+        z.object({ seoDefaults: z.record(z.string(), z.unknown()).optional(), siteSchema: z.record(z.string(), z.unknown()).optional(), robotsConfig: z.record(z.string(), z.unknown()).optional(), sitemapConfig: z.record(z.string(), z.unknown()).optional(), rssConfig: z.record(z.string(), z.unknown()).optional() }).shape,
+        async (c, a) => ok("Updated SEO.", await data(c, "PATCH", `/management/seo`, a))
+      ),
+      def(
+        "get_site_files",
+        "List site files",
+        "List the AI-crawler files installed on the connected project (llms.txt / llms-full.txt) \u2014 metadata only.",
+        z.object({}).shape,
+        async (c) => ok("Site files.", await data(c, "GET", `/management/site-files`))
+      ),
+      def(
+        "set_site_file",
+        "Set a site file",
+        "Create or replace an AI-crawler file served at the site root \u2014 `kind` 'llms.txt' or 'llms-full.txt' \u2014 with `content` (plain text, max 5 MB). Rebuilds the site.",
+        z.object({ kind: z.enum(["llms.txt", "llms-full.txt"]), content: z.string() }).shape,
+        async (c, a) => ok("Saved site file.", await data(c, "PUT", `/management/site-files/${s(a.kind)}`, { content: a.content }))
+      ),
+      def(
+        "delete_site_file",
+        "Delete a site file",
+        "Remove an AI-crawler file (llms.txt / llms-full.txt) from the connected project. Provide kind.",
+        z.object({ kind: z.enum(["llms.txt", "llms-full.txt"]) }).shape,
+        async (c, a) => ok("Deleted site file.", await data(c, "DELETE", `/management/site-files/${s(a.kind)}`))
+      ),
+      def(
+        "promote_project",
+        "Promote staging \u2192 production",
+        "Promote the connected project's STAGED build to PRODUCTION \u2014 the one-click publish. Flips prod to the newest staged release (no rebuild) after the QA scan passes. Managed hosting only; needs a publish-enabled connection.",
+        z.object({}).shape,
+        async (c) => ok("Promoted to production.", await data(c, "POST", `/management/projects/promote`))
+      ),
+      def(
+        "list_entry_versions",
+        "List a content entry's versions",
+        "List a content entry's version history (newest first) \u2014 each version's number, data snapshot, and when it was saved. Use it to find a past state to restore.",
+        z.object({ entryId: z.string().min(1) }).shape,
+        async (c, a) => ok("Entry versions.", await data(c, "GET", `/management/content/entries/${s(a.entryId)}/versions`))
+      ),
+      def(
+        "restore_entry_version",
+        "Restore a content entry to a past version",
+        "Restore a content entry to a past version (undo). Copies that version's data back as the current DRAFT (non-destructive). Publish afterwards to take it live. Provide entryId and the version number (from list_entry_versions).",
+        z.object({ entryId: z.string().min(1), version: z.number().int().positive() }).shape,
+        async (c, a) => ok("Restored entry version.", await data(c, "POST", `/management/content/entries/${s(a.entryId)}/versions/${a.version}/restore`))
+      ),
+      // ── Project / workspace (parity with remote /mcp) ──
+      def(
+        "get_project",
+        "Get the connected project",
+        "Get the connected project's info \u2014 id, name, slug, subdomain, and its live URL (https://<handle>.bettercms.site). Use it to tell the user where their site is published / link the result.",
+        z.object({}).shape,
+        async (c) => ok("Project.", await data(c, "GET", `/management/projects/current`))
+      ),
+      def(
+        "list_projects",
+        "List projects",
+        "List the projects this key can see \u2014 id, name, slug, and live URL each. A project-scoped key sees only its own project; a workspace-level key sees every project in the workspace. Use it to find a project you created earlier, or to confirm which sites exist before acting.",
+        z.object({}).shape,
+        async (c) => ok("Projects.", await data(c, "GET", `/management/projects`))
+      ),
+      def(
+        "update_project",
+        "Update the connected project",
+        "Update the connected project's settings \u2014 rename it, change its slug/description, SEO defaults, or visibility. Only the provided fields change.",
+        z.object({ name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), visibility: z.string().optional(), seoDefaults: z.record(z.string(), z.unknown()).optional() }).shape,
+        async (c, a) => ok("Updated project.", await data(c, "PATCH", `/management/projects/current`, a))
+      ),
+      def(
+        "create_project",
+        "Create a new project",
+        "Create a NEW project (site) in the connected workspace. Blank by default; pass templateId to seed curated content, or framework ('next'|'astro') to record the starter. Returns the new project's id and slug. (Use clone_project instead to duplicate an existing project.)",
+        z.object({ name: z.string().min(1), slug: z.string().optional(), description: z.string().optional(), templateId: z.string().optional(), framework: z.enum(["next", "astro"]).optional() }).shape,
+        async (c, a) => ok("Created project.", await data(c, "POST", `/management/projects`, a))
+      ),
+      def(
+        "clone_project",
+        "Clone a project",
+        "Clone (duplicate) a project as a reusable template into the connected workspace. Copies pages, content models + entries, components, media, forms, and SEO/custom-code settings; excludes submissions, analytics, domains, and secrets. Returns the new project's id and slug. Omit sourceProjectId to clone the connected project.",
+        z.object({ sourceProjectId: z.string().optional(), name: z.string().optional(), slug: z.string().optional() }).shape,
+        async (c, a) => ok("Cloned project.", await data(c, "POST", `/management/projects/clone`, a))
+      ),
+      def(
+        "create_template",
+        "Save a project/page as a template",
+        "Save a project (or one page) as a REUSABLE template \u2014 a frozen snapshot of its content models, pages, entries, components, and forms (secrets/domains/analytics excluded). Later seed a new project from it with create_project { templateId }. Set visibility 'public' to list it in the cross-workspace gallery. Returns the new template's id.",
+        z.object({ sourceProjectId: z.string().min(1), name: z.string().min(1), scope: z.string().optional(), sourcePageId: z.string().optional(), description: z.string().optional(), visibility: z.string().optional() }).shape,
+        async (c, a) => ok("Created template.", await data(c, "POST", `/management/templates`, a))
+      ),
+      def(
+        "list_templates",
+        "List saved templates",
+        "List your workspace's saved templates (id, name, scope, visibility). Use a template's id as create_project { templateId } to seed a new project from it.",
+        z.object({}).shape,
+        async (c) => ok("Templates.", await data(c, "GET", `/management/templates`))
+      ),
+      // ── Content models (read/metadata; parity with remote /mcp) ──
+      def(
+        "list_content_models",
+        "List content models",
+        "List the content models (reusable schemas for dynamic collections like Blog/Products) in the connected project.",
+        z.object({}).shape,
+        async (c) => ok("Content models.", await data(c, "GET", `/management/content/models`))
+      ),
+      def(
+        "get_content_model",
+        "Get a content model",
+        "Get one content model by id INCLUDING its full field schema (keys, types, nested group/repeater children). Read this before add_field so you know the existing keys.",
+        z.object({ modelId: z.string().min(1) }).shape,
+        async (c, a) => ok("Content model.", await data(c, "GET", `/management/content/models/${s(a.modelId)}`))
+      ),
+      def(
+        "update_content_model",
+        "Update a content model's metadata",
+        "Rename a content model or edit its description/slug (metadata only \u2014 does NOT touch fields; use add_field to extend the schema). Provide modelId plus the fields to change.",
+        z.object({ modelId: z.string().min(1), name: z.string().optional(), slug: z.string().optional(), description: z.string().optional() }).shape,
+        async (c, a) => ok("Updated content model.", await data(c, "PATCH", `/management/content/models/${s(a.modelId)}`, { name: a.name, slug: a.slug, description: a.description }))
+      ),
+      def(
+        "get_content_types",
+        "Get generated TypeScript types",
+        "Get the auto-generated TypeScript types for the connected project's content models/pages. Pull these to write correctly-typed code against the BetterCMS delivery SDK in the user's site.",
+        z.object({}).shape,
+        async (c) => ok("Content types.", await data(c, "GET", `/management/content/types`))
+      ),
+      // ── Pages (metadata edit; parity with remote /mcp) ──
+      def(
+        "update_page",
+        "Edit a page's metadata",
+        "Edit a page's metadata \u2014 title, slug, SEO metaTitle/metaDescription, and publish status (draft|published). This is the slug/title/SEO editor (it does NOT change the field schema or content \u2014 use add_page_field / set_page_content for those). Renaming the slug keeps the page's content intact. Provide pageId plus the fields to change.",
+        z.object({ pageId: z.string().min(1), title: z.string().optional(), slug: z.string().optional(), metaTitle: z.string().optional(), metaDescription: z.string().optional(), status: z.enum(["draft", "published"]).optional() }).shape,
+        async (c, a) => ok("Updated page.", await data(c, "PATCH", `/management/pages/${s(a.pageId)}/meta`, { title: a.title, slug: a.slug, metaTitle: a.metaTitle, metaDescription: a.metaDescription, status: a.status }))
+      ),
+      // ── Code + deploy (parity with remote /mcp; needs artifact:write) ──
+      def(
+        "pull_project_source",
+        "Pull the project's live source",
+        "Get the connected project's CURRENT live source/build so you can edit it locally. Returns a presigned tarball download url (1h) + the live commit sha \u2014 download it, extract, edit the files, then call deploy_project. If the project is connected to a GitHub repo, returns `github: {owner, repo}` so you can `git clone` that instead.",
+        z.object({}).shape,
+        async (c) => ok("Project source.", await data(c, "GET", `/management/projects/source`))
+      ),
+      def(
+        "deploy_project",
+        "Deploy new source/build",
+        "Deploy new source/build for the connected project and make it live at its <handle>.bettercms.site. Pass a .tgz or .zip of the project as a base64 string in `data`: SOURCE (has package.json) is built server-side in an isolated sandbox; a prebuilt static site is served as-is. node_modules/.git are stripped automatically. Returns the release id + sha \u2014 then poll get_deploy_status until it is live.",
+        z.object({ data: z.string().min(1).describe("base64 .tgz/.zip of the project"), mimeType: z.string().optional() }).shape,
+        async (c, a) => ok("Deploy queued.", await raw(c, `/management/projects/deploy`, s(a.data), a.mimeType))
+      ),
+      def(
+        "get_deploy_status",
+        "Get deploy/build status",
+        "Get the connected project's deploy/build status: state (idle|queued|building|failed), whether it's publishing, the live commit sha, when it went live, and any build error. Poll this after deploy_project until state is idle with your sha live.",
+        z.object({}).shape,
+        async (c) => ok("Deploy status.", await data(c, "GET", `/management/projects/deploy-status`))
+      )
+    ];
+  }
   const defs = [
     {
       name: "list_pages",
@@ -644,6 +923,28 @@ function buildToolDefs(deps) {
         })
       )
     },
+    {
+      name: "create_content_model",
+      config: {
+        title: "Create a content model (reusable schema)",
+        description: "Create a content model \u2014 a reusable schema for a dynamic collection (Blog, Products, Testimonials). `fields` may NEST: type 'group' = one nested object of child fields; type 'repeater' = a repeatable array of child objects. Put child fields in each group/repeater's own `fields` (any depth).",
+        inputSchema: createModelInput.shape
+      },
+      handler: guard(
+        async (args) => withClient(async (client) => {
+          const model = await client.createModel({
+            name: args.name,
+            slug: args.slug,
+            ...args.description !== void 0 ? { description: args.description } : {},
+            fields: toFields(args.fields)
+          });
+          return ok(
+            `Created content model '${model.name}' (${model.fields.length} field(s)).`,
+            model
+          );
+        })
+      )
+    },
     {
       name: "add_field",
       config: {
@@ -685,23 +986,20 @@ function buildToolDefs(deps) {
       )
     },
     {
-      name: "create_entry",
+      name: "create_content_entry",
       config: {
         title: "Create a content entry",
-        description: "Create a content entry under a model. If data/status are provided they are applied in a follow-up update (entries are created as empty drafts).",
+        description: "Create a content entry under a model. Pass its field VALUES in `data`, keyed by field key \u2014 INCLUDE ALL REQUIRED FIELDS (create validates them). New entries are drafts; pass status:'published' to take it live. Read get_content_model first for the field keys and which are required.",
         inputSchema: createEntryInput.shape
       },
       handler: guard(
         async (args) => withClient(async (client) => {
           const created = await client.createEntry({
             contentModelId: args.contentModelId,
-            ...args.slug !== void 0 ? { slug: args.slug } : {}
+            ...args.slug !== void 0 ? { slug: args.slug } : {},
+            ...args.data !== void 0 ? { data: args.data } : {}
           });
-          const needsUpdate = args.data !== void 0 || args.status !== void 0;
-          const entry = needsUpdate ? await client.updateEntry(created.id, {
-            ...args.data !== void 0 ? { data: args.data } : {},
-            ...args.status !== void 0 ? { status: args.status } : {}
-          }) : created;
+          const entry = args.status !== void 0 && args.status !== "draft" ? await client.updateEntry(created.id, { status: args.status }) : created;
           return ok(
             `Created entry '${entry.slug}' (id ${entry.id}, status ${entry.status}).`,
             entry
@@ -713,7 +1011,7 @@ function buildToolDefs(deps) {
       name: "set_page_content",
       config: {
         title: "Set a page's field values (content)",
-        description: "Set a page's field VALUES \u2014 the actual content. For a SINGLETON page (Home, About, Site Settings) this creates or updates its one entry, so call it again to edit. `data` is keyed by field key: a nested 'array' (zone) value is an OBJECT { nonRepeatable: { childKey: value }, repeatable: [ { childKey: value } ] }; a primitive 'array' is a plain list; an 'image' value is an asset URL. Read the schema first with get_page. This is how you populate Home/About/Settings \u2014 create_entry is for dynamic collections only.",
+        description: "Set a page's field VALUES \u2014 the actual content. For a SINGLETON page (Home, About, Site Settings) this creates or updates its one entry, so call it again to edit. `data` is keyed by field key: a nested 'array' (zone) value is an OBJECT { nonRepeatable: { childKey: value }, repeatable: [ { childKey: value } ] }; a primitive 'array' is a plain list; an 'image' value is an asset URL. Read the schema first with get_page. This is how you populate Home/About/Settings \u2014 create_content_entry is for dynamic collections only.",
         inputSchema: setPageContentInput.shape
       },
       handler: guard(
@@ -730,7 +1028,7 @@ function buildToolDefs(deps) {
       )
     },
     {
-      name: "list_entries",
+      name: "list_content_entries",
       config: {
         title: "List content entries (incl. drafts)",
         description: "List content entries \u2014 including drafts \u2014 filtered by model and/or page. Use it to SEE existing content before editing. For a singleton page, pass its pageId to get its single entry.",
@@ -748,7 +1046,7 @@ function buildToolDefs(deps) {
       )
     },
     {
-      name: "get_entry",
+      name: "get_content_entry",
       config: {
         title: "Get a content entry (with its values)",
         description: "Get one content entry by id INCLUDING its `data` (field values), even when draft.",
@@ -762,7 +1060,7 @@ function buildToolDefs(deps) {
       )
     },
     {
-      name: "update_entry",
+      name: "update_content_entry",
       config: {
         title: "Update a content entry's values",
         description: "Update a content entry's `data` (field values) and/or status by id. `data` is keyed by field key; a nested 'array' (zone) value is an object { nonRepeatable: {\u2026}, repeatable: [{\u2026}] }, a primitive 'array' is a plain list. Use this to edit an existing entry; for a singleton page prefer set_page_content.",
@@ -811,7 +1109,7 @@ function buildToolDefs(deps) {
       )
     },
     {
-      name: "delete_entry",
+      name: "delete_content_entry",
       config: {
         title: "Delete a content entry",
         description: "DELETE a single content entry. Destructive but REVERSIBLE (soft-delete, restorable from the dashboard) and audit-logged. Use it to remove content created by mistake.",
@@ -959,7 +1257,41 @@ function buildToolDefs(deps) {
           return ok(`Updated component '${cmp.name}' (id ${cmp.id}).`, cmp);
         })
       )
-    }
+    },
+    // ── AI content + SEO actions (Option B) ────────────────────────────────────
+    {
+      name: "write_content",
+      config: {
+        title: "Write, rewrite, or translate content",
+        description: "AI-write a piece of copy: action 'write' (draft from a brief), 'rewrite' (improve existing copy), or 'translate' (needs targetLang). Returns the suggested text \u2014 apply it with set_page_content or update_content_entry. Uses the workspace's own Anthropic key (BYOK, unmetered) or platform AI credits.",
+        inputSchema: writeContentInput.shape
+      },
+      handler: guard(
+        async (args) => withClient(async (client) => {
+          const suggestion = await client.writeContent(args);
+          return ok(`Generated ${args.action} suggestion (${suggestion.length} chars).`, { suggestion });
+        })
+      )
+    },
+    {
+      name: "generate_seo_meta",
+      config: {
+        title: "Generate SEO metadata",
+        description: "Generate SEO metadata (metaTitle, metaDescription, keywords, optional JSON-LD) for a piece of content. Pass the page/entry content as `text`. Returns a suggestion to apply via update_page or the entry SEO fields.",
+        inputSchema: generateSeoMetaInput.shape
+      },
+      handler: guard(
+        async (args) => withClient(async (client) => {
+          const meta = await client.generateSeoMeta(args);
+          return ok(`Generated SEO metadata: "${meta.metaTitle}".`, meta);
+        })
+      )
+    },
+    // ── Lifecycle tools (parity with the remote /mcp surface) ──────────────────
+    // Media management, form submissions (leads), redirects, SEO, AEO site-files,
+    // promote, and entry version history. These call the management endpoints straight
+    // through the client's request plumbing — no bespoke SDK method per endpoint.
+    ...lifecycleTools()
   ];
   return defs;
 }
@@ -1021,9 +1353,9 @@ above, including nested group/repeater), required?. Confirm, then call:
 - a page  \u2192 \`add_page_field\` { pageId, key, label, type, ... }
 Both are additive: they reject a key that already exists and never retype/overwrite
 an existing field (edit those in the dashboard).`;
-var ENTRY_FLOW = `### Create an entry \u2192 \`create_entry\` tool
+var ENTRY_FLOW = `### Create an entry \u2192 \`create_content_entry\` tool
 Create a content entry under a model. Ask: which model (id), the field values (data),
-status (draft/published). Then call \`create_entry\` { contentModelId, data?, status?, slug? }.`;
+status (draft/published). Then call \`create_content_entry\` { contentModelId, data?, status?, slug? }.`;
 var FORM_FLOW = `### Form authoring \u2192 \`create_form\` / \`update_form\` tools
 Author a form (then the user embeds it with \`<BcmsForm form={getForm('Name')} />\` from
 @bettercms-ai/next). Confirm the fields with the user BEFORE creating. Never guess fields.
@@ -1050,6 +1382,32 @@ confirm. Never guess the layout.
 4. **Confirm the structure** (AskUserQuestion: show the block tree), then \`create_component\`
    { name, slug, category?, blockJson, props? } (returns the id), or \`update_component\`
    { componentId, ... } \u2014 note updating re-bakes every page that embeds it.`;
+var BUILD_SITE_FLOW = `### Build a whole site (schema \u2192 pages \u2192 AI copy) \u2192 composes the flows below
+End-to-end authoring from a repo or a brief. Confirm-first at every stage.
+1. **Schema** \u2014 run the whole-project schema design above: propose the page/zone/field tree,
+   get the user's approval, then \`create_page\` per page.
+2. **Copy** \u2014 for each page/entry, draft the real text with \`write_content\` (action 'write',
+   pass the section as the brief + the page title as \`context\`). Review with the user, then
+   apply via \`set_page_content\` / \`create_content_entry\` / \`update_content_entry\`.
+3. **SEO** \u2014 run the SEO flow to fill metaTitle/metaDescription for each page.
+Never invent brand facts \u2014 ask the user for anything the repo/brief doesn't state.`;
+var LANDING_PAGES_FLOW = `### Generate landing pages (programmatic SEO / ABM) \u2192 \`write_content\` + \`create_content_entry\` + \`generate_seo_meta\`
+Spin up many pages sharing one template, each personalized per row (company, keyword, persona).
+1. **Template** \u2014 ensure a dynamic page or content model exists for the template
+   (\`create_page\` pageType 'dynamic' / \`create_content_model\`); its fields are the per-page slots.
+2. **Dataset** \u2014 get the list of targets from the user (rows of variables, e.g. company + industry).
+3. **Per row (loop)** \u2014 draft each slot with \`write_content\` (the row's variables as the brief/
+   \`context\`), pick a unique slug, then \`create_content_entry\` { contentModelId, data, slug, status }.
+   Add SEO with \`generate_seo_meta\` on the drafted copy and store it on the entry.
+Confirm the first 1\u20132 rows with the user before generating the rest. For hundreds of rows,
+the dashboard AI Page Builder bulk-imports a CSV \u2014 mention it.`;
+var SEO_FLOW = `### Optimize SEO \u2192 \`generate_seo_meta\` + the page/entry update tools
+Fill or refresh SEO metadata across the site.
+1. **Target** \u2014 pick the pages/entries (\`list_pages\` / \`list_content_entries\`); confirm scope with the user.
+2. **Per target** \u2014 read its content (\`get_page\` / \`get_content_entry\`), call \`generate_seo_meta\` with that
+   content as \`text\`, review the suggested metaTitle/metaDescription/keywords, then apply it via
+   the page/entry update tools (or the dashboard SEO fields).
+Keep titles ~60 chars and descriptions ~155; don't overwrite good existing meta without asking.`;
 function registerPrompts(server) {
   server.registerPrompt(
     "studio",
@@ -1070,7 +1428,7 @@ function registerPrompts(server) {
 ${request ? `The user's request: "${request}".
 ` : ""}
 First, **preflight**: confirm the bettercms tools are loaded (\`create_page\`, \`add_field\`,
-\`create_entry\`). If \`create_page\` is missing and only \`create_model\` shows, the host has a
+\`create_content_entry\`). If \`create_page\` is missing and only \`create_model\` shows, the host has a
 stale cached MCP \u2014 tell the user to run \`rm -rf ~/.npm/_npx\` and restart, then stop.
 
 Then **route** to the matching sub-flow below based on the request and conversation
@@ -1095,6 +1453,12 @@ ${FORM_FLOW}
 
 ${COMPONENT_FLOW}
 
+${BUILD_SITE_FLOW}
+
+${LANDING_PAGES_FLOW}
+
+${SEO_FLOW}
+
 This assistant is extensible: when new BetterCMS tools are added, a new sub-flow appears
 here \u2014 route to it the same way.`
           }
@@ -1119,7 +1483,7 @@ here \u2014 route to it the same way.`
             type: "text",
             text: `Design the BetterCMS content schema for this repository.${request ? ` Focus: "${request}".` : ""}
 
-Preflight: if \`create_page\` isn't available (only create_model/add_field/create_entry),
+Preflight: if \`create_page\` isn't available (only create_model/add_field/create_content_entry),
 the host has a stale cached MCP \u2014 tell the user to \`rm -rf ~/.npm/_npx\` and restart, then stop.
 
 ${SCHEMA_PROPOSAL_FLOW}
@@ -1149,7 +1513,7 @@ landed in. On 409 slug_taken, offer an alternative slug; on 401/403, the MCP key
             type: "text",
             text: `Create a BetterCMS page via the \`create_page\` tool.${request ? ` The user wants: "${request}".` : ""}
 
-Preflight: if \`create_page\` isn't available (only create_model/add_field/create_entry),
+Preflight: if \`create_page\` isn't available (only create_model/add_field/create_content_entry),
 the host has a stale cached MCP \u2014 tell the user to \`rm -rf ~/.npm/_npx\` and restart, then stop.
 
 ${PAGE_FLOW}
@@ -1213,11 +1577,88 @@ On 409 slug_taken, offer an alternative slug; on 401/403, the MCP key needs (re)
       ]
     })
   );
+  server.registerPrompt(
+    "build_site",
+    {
+      title: "Build a site (guided, end-to-end)",
+      description: "Author a whole BetterCMS site from a repo or a brief: design the schema, create the pages, draft the copy with AI (write_content), and fill SEO (generate_seo_meta).",
+      argsSchema: {
+        request: z2.string().optional().describe("what to build, e.g. 'a SaaS marketing site from this repo'")
+      }
+    },
+    ({ request }) => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Build a BetterCMS site end-to-end.${request ? ` The user wants: "${request}".` : ""}
+
+${BUILD_SITE_FLOW}
+
+${SEO_FLOW}
+
+Confirm each stage with the user before writing. On 401/403, the MCP key needs (re)authorizing.`
+          }
+        }
+      ]
+    })
+  );
+  server.registerPrompt(
+    "generate_landing_pages",
+    {
+      title: "Generate landing pages (programmatic SEO / ABM)",
+      description: "Spin up many personalized landing pages from one template + a dataset, drafting each page's copy with write_content and SEO with generate_seo_meta.",
+      argsSchema: {
+        request: z2.string().optional().describe("the campaign, e.g. 'a page per target company for our ABM push'")
+      }
+    },
+    ({ request }) => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Generate programmatic landing pages.${request ? ` The user wants: "${request}".` : ""}
+
+${LANDING_PAGES_FLOW}
+
+On 401/403, the MCP key needs (re)authorizing.`
+          }
+        }
+      ]
+    })
+  );
+  server.registerPrompt(
+    "seo_optimize",
+    {
+      title: "Optimize SEO (guided)",
+      description: "Generate and apply SEO metadata (title, description, keywords, JSON-LD) across pages/entries with generate_seo_meta.",
+      argsSchema: {
+        request: z2.string().optional().describe("scope, e.g. 'all blog posts' or 'the home page'")
+      }
+    },
+    ({ request }) => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `Optimize SEO metadata.${request ? ` The user wants: "${request}".` : ""}
+
+${SEO_FLOW}
+
+On 401/403, the MCP key needs (re)authorizing.`
+          }
+        }
+      ]
+    })
+  );
 }
 
 // src/server.ts
 var SERVER_NAME = "bettercms";
-var SERVER_VERSION = "0.1.0";
+var SERVER_VERSION = "1.3.0";
 function buildServer(deps) {
   const server = new McpServer(
     { name: SERVER_NAME, version: SERVER_VERSION },