Cloudflare MCP Server

Instructions

Implementation Reference

• src/tools/zone-management.ts:83-109 (handler)

  The main handler function that performs the Cloudflare zone settings update by finding the zone ID, preparing the settings items, and making a PATCH request to the Cloudflare API.

  handler: async (params: any) => {
    const { zone_name, settings } = UpdateZoneSettingsInputSchema.parse(params);
    const zones = await client.get<any[]>('/zones', { name: zone_name });
    if (zones.length === 0) throw new Error(`Zone ${zone_name} not found`);
    const zoneId = zones[0].id;
    const items = Object.entries(settings).map(([id, value]) => ({ id, value }));
    const body = { items };
    const cfClient: any = client as any;
    if (typeof cfClient.patch === 'function') {
      return {
      content: [
        {
          type: "text",
          text: JSON.stringify(await cfClient.patch(`/zones/${zoneId}/settings`, body), null, 2)
        }
      ]
    };
    }
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(await cfClient.request("PATCH", `/zones/${zoneId}/settings`, body), null, 2)
        }
      ]
    };
  },

• src/tools/zone-management.ts:72-76 (schema)

  Zod input schema for the tool, extending the base zone_name schema with a settings object. Base schema defined earlier at lines 46-48.

  // update_zone_settings
  const UpdateZoneSettingsInputSchema = GetZoneSettingsInputSchema.extend({
    settings: z.record(z.any()),
  });

• src/tools/zone-management.ts:152-159 (registration)

  Local registration of the update_zone_settings tool within the zone-management tools module.

  return {
    tools: {
      'cloudflare-dns-mcp/list_zones': listZonesTool,
      'cloudflare-dns-mcp/get_zone_settings': getZoneSettingsTool,
      'cloudflare-dns-mcp/update_zone_settings': updateZoneSettingsTool,
      'cloudflare-dns-mcp/purge_cache': purgeCacheTool,
    },
  };

• src/index.ts:25-32 (registration)

  Global aggregation of all tools including zoneTools (which contains update_zone_settings) into allTools object.

  const allTools = {
    ...dnsTools.tools,
    ...securityTools.tools,
    ...sslCertTools.tools,
    ...echoTools.tools,
    ...redirectTools.tools,
    ...zoneTools.tools,
  } as Record<string, any>;

• src/index.ts:48-52 (registration)

  Registration under sanitized tool name 'cloudflare-dns-mcp_update_zone_settings' by replacing '/' with '_' for MCP server compatibility.

  const toolsMap: Record<string, any> = {};
  for (const tool of Object.values(allTools)) {
    const safeName = tool.name.replace(/[^a-zA-Z0-9_-]/g, '_');
    toolsMap[safeName] = tool;
  }