discord_edit_webhook

Modify an existing Discord webhook's name, avatar, or channel to update automated message delivery settings.

Instructions

Edits an existing webhook for a Discord channel

Input Schema

TableJSON Schema

Name	Required	Description	Default
`webhookId`	Yes
`webhookToken`	No
`name`	No
`avatar`	No
`channelId`	No
`reason`	No

Implementation Reference

src/tools/webhooks.ts:117-160 (handler)

The main handler function for 'discord_edit_webhook' tool. It validates input using EditWebhookSchema, fetches the webhook using Discord client, edits it with provided parameters, and returns success or error response.

export async function editWebhookHandler(
  args: unknown,
  context: ToolContext
): Promise<ToolResponse> {
  const { webhookId, webhookToken, name, avatar, channelId, reason } =
    EditWebhookSchema.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,
      };
    }

    // Edit the webhook
    await webhook.edit({
      name,
      avatar,
      channel: channelId,
      reason,
    });

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

src/schemas.ts:119-126 (schema)

Zod schema defining the input parameters and validation for the discord_edit_webhook tool.

export const EditWebhookSchema = z.object({
  webhookId: z.string(),
  webhookToken: z.string().optional(),
  name: z.string().optional(),
  avatar: z.string().optional(),
  channelId: z.string().optional(),
  reason: z.string().optional(),
});

src/tool-list.ts:272-287 (registration)

Registration entry for the tool including name, description, and JSON schema compatible input schema, likely used in MCP tools/list response.

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

src/server.ts:199-202 (registration)

Dispatch/registration case in server.ts that calls the editWebhookHandler upon tool invocation.

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

src/transport.ts:376-378 (registration)
Dispatch case in transport.ts HTTP handler that routes 'discord_edit_webhook' to editWebhookHandler.
```
case 'discord_edit_webhook':
  result = await editWebhookHandler(params, this.toolContext!);
  break;
```

MCP-Discord