discord_delete_webhook

Delete an existing Discord webhook to remove automated message delivery from a channel. This tool removes webhooks by ID and token, with optional audit log reason.

Instructions

Deletes an existing webhook for a Discord channel

Input Schema

TableJSON Schema

Name	Required	Description	Default
`webhookId`	Yes
`webhookToken`	No
`reason`	No

Implementation Reference

src/tools/webhooks.ts:163-200 (handler)

The core handler function that implements the discord_delete_webhook tool logic: validates input, fetches the webhook, deletes it, and handles errors.

export async function deleteWebhookHandler(
  args: unknown,
  context: ToolContext
): Promise<ToolResponse> {
  const { webhookId, webhookToken, reason } = DeleteWebhookSchema.parse(args);
  try {
    if (!context.client.isReady()) {
      return {
        content: [{ type: 'text', text: 'Discord client not logged in.' }],
        isError: true,
      };
    }

    const webhook = await context.client.fetchWebhook(webhookId, webhookToken);
    if (!webhook) {
      return {
        content: [
          { type: 'text', text: `Cannot find webhook with ID: ${webhookId}` },
        ],
        isError: true,
      };
    }

    // Delete the webhook
    await webhook.delete(reason || 'Webhook deleted via API');

    return {
      content: [
        {
          type: 'text',
          text: `Successfully deleted webhook with ID: ${webhook.id}`,
        },
      ],
    };
  } catch (error) {
    return handleDiscordError(error);
  }
}

src/tool-list.ts:288-300 (schema)

Tool metadata and input schema definition used for MCP tools/list response.

{
  name: 'discord_delete_webhook',
  description: 'Deletes an existing webhook for a Discord channel',
  inputSchema: {
    type: 'object',
    properties: {
      webhookId: { type: 'string' },
      webhookToken: { type: 'string' },
      reason: { type: 'string' },
    },
    required: ['webhookId'],
  },
},

src/schemas.ts:128-132 (schema)

Zod validation schema parsed in the handler for input parameters.

export const DeleteWebhookSchema = z.object({
  webhookId: z.string(),
  webhookToken: z.string().optional(),
  reason: z.string().optional(),
});

src/server.ts:204-207 (registration)

Dispatch registration in the main MCP server CallToolRequestSchema handler switch statement.

case 'discord_delete_webhook':
  this.logClientState('before discord_delete_webhook handler');
  toolResponse = await deleteWebhookHandler(args, this.toolContext);
  return toolResponse;

src/transport.ts:379-380 (registration)
Dispatch case in the HTTP transport handler for direct method calls.
```
case 'discord_delete_webhook':
  result = await deleteWebhookHandler(params, this.toolContext!);
```

MCP-Discord