discord-mcp

Instructions

Implementation Reference

• src/tools/webhook-tools.ts:144-160 (handler)

  The handler function for the delete_webhook tool. It fetches the webhook using the Discord client and deletes it, handling errors with withErrorHandling and returning formatted success/error responses.

  async ({ webhookId, reason }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const webhook = await client.fetchWebhook(webhookId);
      const webhookName = webhook.name;
  
      await webhook.delete(reason);
  
      return { webhookId, webhookName, message: 'Webhook deleted successfully' };
    });
  
    if (!result.success) {
      return { content: [{ type: 'text', text: result.error }], isError: true };
    }
  
    return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
  }

• src/tools/webhook-tools.ts:140-143 (schema)

  Zod schema defining the input parameters for the delete_webhook tool: required webhookId and optional reason.

  {
    webhookId: z.string().describe('The ID of the webhook'),
    reason: z.string().optional().describe('Reason for deleting'),
  },

• src/tools/webhook-tools.ts:137-161 (registration)

  Registration of the delete_webhook tool using server.tool(), including name, description, input schema, and handler function within the registerWebhookTools function.

  server.tool(
    'delete_webhook',
    'Delete a webhook',
    {
      webhookId: z.string().describe('The ID of the webhook'),
      reason: z.string().optional().describe('Reason for deleting'),
    },
    async ({ webhookId, reason }) => {
      const result = await withErrorHandling(async () => {
        const client = await getDiscordClient();
        const webhook = await client.fetchWebhook(webhookId);
        const webhookName = webhook.name;
  
        await webhook.delete(reason);
  
        return { webhookId, webhookName, message: 'Webhook deleted successfully' };
      });
  
      if (!result.success) {
        return { content: [{ type: 'text', text: result.error }], isError: true };
      }
  
      return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
    }
  );