Discord

Send messages to Discord via webhook or bot API. You configure your own webhook URL or bot token โ€” we don't bundle any.

Setup options

Option A: Webhook (simplest)

  1. Open your Discord server โ†’ channel settings โ†’ Integrations โ†’ Webhooks โ†’ "New Webhook"
  2. Copy the webhook URL
  3. Set DISCORD_WEBHOOK_URL in your environment

Option B: Bot (more powerful)

  1. Create an application at discord.com/developers
  2. Add a bot, copy the token
  3. Invite the bot to your server (OAuth2 URL generator with bot scope + Send Messages permission)
  4. Set DISCORD_BOT_TOKEN in your environment

Tools provided

ToolRequiresPurpose
discord_sendDISCORD_WEBHOOK_URLPlain text to webhook
discord_send_embedDISCORD_WEBHOOK_URLRich embed (title + description + url)
discord_send_botDISCORD_BOT_TOKENMessage to specific channel ID via bot

All tools are mutation

Each Discord send is marked permission: "mutation". By default the gateway prompts via approvals. Add an auto-allow rule if you trust the tool:

curl -X POST http://127.0.0.1:18789/approvals/rules \
  -d '{
    "toolPattern": "discord_*",
    "agent": "*",
    "policy": "auto-allow",
    "reason": "trusted Discord channel"
  }'

Privacy

Messages go directly from your gateway to Discord's API. No OpenVesper servers involved.

Source

Implementation: packages/plugins/discord/

What's next?