Cloudflare MCP Server

Instructions

Implementation Reference

• src/tools/dns-records.ts:239-253 (handler)

  The core handler function that validates input parameters, looks up the zone ID from the zone name, and performs the DELETE request to Cloudflare's DNS records API endpoint.

  handler: async (params: z.infer<typeof DeleteDnsRecordInputSchema>) => {
    const { zone_name, record_id } = DeleteDnsRecordInputSchema.parse(params);
    const zones = await client.get<Array<{ id: string; name: string }>>('/zones', { name: zone_name });
    if (zones.length === 0) throw new Error(`Zone ${zone_name} not found`);
    const zoneId = zones[0].id;
    await client.delete(`/zones/${zoneId}/dns_records/${record_id}`);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({ success: true, id: record_id }, null, 2)
        }
      ]
    };
  },

• src/tools/dns-records.ts:233-233 (schema)

  Zod input schema defining required parameters: zone_name (string) and record_id (string). Converted to JSON schema for the tool's inputSchema.

  const DeleteDnsRecordInputSchema = z.object({ zone_name: z.string(), record_id: z.string() });

• src/tools/dns-records.ts:338-338 (registration)

  Local registration of the tool object in the getDnsTools() return value using the slash-separated name.

  'cloudflare-dns-mcp/delete_dns_record': deleteDnsRecordTool,

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

  Main server registration: calls getDnsTools and spreads DNS tools into the combined allTools map used for MCP server toolset.

  const dnsTools = getDnsTools(cfClient);
  const securityTools = getSecurityTools(cfClient);
  const sslCertTools = getSslCertTools(cfClient);
  const zoneTools = getZoneManagementTools(cfClient);
  const echoTools = getEchoTools();
  const redirectTools = getRedirectTools(cfClient);
  
  const allTools = {
    ...dnsTools.tools,
    ...securityTools.tools,
    ...sslCertTools.tools,
    ...echoTools.tools,
    ...redirectTools.tools,
    ...zoneTools.tools,
  } as Record<string, any>;

• src/index.ts:50-52 (helper)

  Helper function that sanitizes tool names, replacing '/' with '_', creating the exact queried name 'cloudflare-dns-mcp_delete_dns_record' from 'cloudflare-dns-mcp/delete_dns_record'.

    const safeName = tool.name.replace(/[^a-zA-Z0-9_-]/g, '_');
    toolsMap[safeName] = tool;
  }