discord_create_webhook
Create a Discord webhook to automate message delivery and integrate external services with specific channels, enabling automated notifications and data flow.
Instructions
Creates a new webhook for a Discord channel
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channelId | Yes | ||
| name | Yes | ||
| avatar | No | ||
| reason | No |
Implementation Reference
- src/index.ts:1220-1265 (handler)The switch case handler that executes the discord_create_webhook tool. It validates input using CreateWebhookSchema, fetches the channel, creates a webhook using channel.createWebhook(), and returns the webhook ID and token on success.
case "discord_create_webhook": { const { channelId, name, avatar, reason } = CreateWebhookSchema.parse(args); try { if (!client.isReady()) { return { content: [{ type: "text", text: "Discord client not logged in. Please use discord_login tool first." }], isError: true }; } const channel = await client.channels.fetch(channelId); if (!channel || !channel.isTextBased()) { return { content: [{ type: "text", text: `Cannot find text channel with ID: ${channelId}` }], isError: true }; } // Check if the channel supports webhooks if (!('createWebhook' in channel)) { return { content: [{ type: "text", text: `Channel type does not support webhooks: ${channelId}` }], isError: true }; } // Create the webhook const webhook = await channel.createWebhook({ name: name, avatar: avatar, reason: reason }); return { content: [{ type: "text", text: `Successfully created webhook with ID: ${webhook.id} and token: ${webhook.token}` }] }; } catch (error) { return { content: [{ type: "text", text: `Failed to create webhook: ${error}` }], isError: true }; } } - src/index.ts:121-126 (schema)Zod schema defining the input parameters for the discord_create_webhook tool: channelId (required), name (required), avatar (optional), reason (optional). Used for validation in the handler.
const CreateWebhookSchema = z.object({ channelId: z.string(), name: z.string(), avatar: z.string().optional(), reason: z.string().optional() }); - src/index.ts:399-411 (registration)Tool registration in the MCP server's listTools response. Specifies the tool name, description, and inputSchema matching the CreateWebhookSchema.
{ name: "discord_create_webhook", description: "Creates a new webhook for a Discord channel", inputSchema: { type: "object", properties: { channelId: { type: "string" }, name: { type: "string" }, avatar: { type: "string" }, reason: { type: "string" } }, required: ["channelId", "name"] }