Webflow

Instructions

Implementation Reference

• src/tools/pages.ts:115-129 (handler)

  The handler function that performs the actual tool logic: calls the Webflow API to update page settings using the provided page_id, localeId, and body.

  async ({ page_id, localeId, body }) => {
    try {
      const response = await getClient().pages.updatePageSettings(
        page_id,
        {
          localeId,
          body,
        },
        requestOptions
      );
      return formatResponse(response);
    } catch (error) {
      return formatErrorResponse(error);
    }
  }

• src/tools/pages.ts:98-130 (registration)

  Registers the "pages_update_page_settings" tool with the MCP server, including title, description, input schema, and handler function.

  server.registerTool(
    "pages_update_page_settings",
    {
      title: "Update Page Settings",
      description:
        "Update page settings including SEO metadata, Open Graph data, slug, and publishing status.",
      inputSchema: z.object({
        page_id: z.string().describe("Unique identifier for the page."),
        localeId: z
          .string()
          .optional()
          .describe(
            "Unique identifier for a specific locale. Applicable when using localization."
          ),
        body: WebflowPageSchema,
      }),
    },
    async ({ page_id, localeId, body }) => {
      try {
        const response = await getClient().pages.updatePageSettings(
          page_id,
          {
            localeId,
            body,
          },
          requestOptions
        );
        return formatResponse(response);
      } catch (error) {
        return formatErrorResponse(error);
      }
    }
  );

• src/schemas/WebflowPageSchema.ts:3-92 (schema)

  Zod schema used for validating the 'body' parameter in the tool's input schema, defining page properties like id, title, slug, SEO, Open Graph, etc.

  export const WebflowPageSchema = z.object({
    id: z.string().describe("Unique identifier for a Page."),
    siteId: z.string().optional().describe("Unique identifier for the Site."),
    title: z.string().optional().describe("Title of the page."),
    slug: z
      .string()
      .optional()
      .describe("Slug of the page (derived from title)."),
    parentId: z
      .string()
      .optional()
      .describe("Unique identifier for the parent folder."),
    collectionId: z
      .string()
      .optional()
      .describe(
        "Unique identifier for the linked collection, NULL id the Page is not part of a collection."
      ),
    createdOn: z.date().optional().describe("Date when the page was created."),
    lastUpdated: z
      .date()
      .optional()
      .describe("Date when the page was last updated."),
    archived: z
      .boolean()
      .optional()
      .describe("Indicates if the page is archived."),
    draft: z.boolean().optional().describe("Indicates if the page is a draft."),
    canBranch: z
      .boolean()
      .optional()
      .describe("Indicates if the page can be branched."),
    isBranch: z
      .boolean()
      .optional()
      .describe("Indicates if the page is Branch of another page."),
    isMembersOnly: z
      .boolean()
      .optional()
      .describe(
        "Indicates whether the Page is restricted by Memberships Controls."
      ),
    seo: z
      .object({
        title: z
          .string()
          .optional()
          .describe("The Page title shown in search engine results."),
        description: z
          .string()
          .optional()
          .describe("The Page description shown in search engine results."),
      })
      .optional()
      .describe("SEO-related fields for the page."),
    openGraph: z
      .object({
        title: z
          .string()
          .optional()
          .describe("The title supplied to Open Graph annotations."),
        titleCopied: z
          .boolean()
          .optional()
          .describe(
            "Indicates the Open Graph title was copied from the SEO title."
          ),
        description: z
          .string()
          .optional()
          .describe("The description supplied to Open Graph annotations."),
        descriptionCopied: z
          .boolean()
          .optional()
          .describe(
            "Indicates the Open Graph description was copied from the SEO description."
          ),
      })
      .optional(),
    localeId: z
      .string()
      .optional()
      .describe(
        "Unique identifier for the page locale. Applicable when using localization."
      ),
    publishedPath: z
      .string()
      .optional()
      .describe("Relative path of the published page."),
  });