discord-mcp

Create webhook

discord_create_webhook

Write

Toolset
Webhooks webhooks
Discord permission
Manage Webhooks
Context cost
262 tokens, estimated1,046 bytes of definition, divided by 4

Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_send_webhook_message. On a forum or media channel, discord_send_webhook_message cannot post through the webhook, since Discord then requires a thread.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintnoRepeating the call can have an additional effect.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel to attach the webhook to.
namerequiredstring
none
Display name for the webhook (max 80 characters).
avataroptionalstring
format uripattern ^https?://
Optional avatar image URL for the webhook.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Named in its description

Also in Webhooks

Raw definition (1,046 bytes)
{
  "name": "discord_create_webhook",
  "description": "Create a webhook on a channel and return its ID and token. SECURITY: the returned token grants anyone the ability to post as this webhook without authentication; treat it as a secret. Requires the Manage Webhooks permission. Use the returned id+token with discord_send_webhook_message. On a forum or media channel, discord_send_webhook_message cannot post through the webhook, since Discord then requires a thread.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to attach the webhook to."
      },
      "name": {
        "type": "string",
        "description": "Display name for the webhook (max 80 characters)."
      },
      "avatar": {
        "description": "Optional avatar image URL for the webhook.",
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      }
    },
    "required": [
      "channel_id",
      "name"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create webhook",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}