discord-mcp

Send webhook message

discord_send_webhook_message

Write

Toolset
Webhooks webhooks
Context cost
795 tokens, estimated3,181 bytes of definition, divided by 4

Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). Supports per-message username/avatar overrides and up to 10 embeds. At least one of content or embeds is required. Returns the new message ID.

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
webhook_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the webhook to send through.
webhook_tokenrequiredstring
none
Secret token of the webhook (from discord_create_webhook or discord_list_webhooks).
contentoptionalstring
none
Plain-text body of the message (max 2000 characters). Optional if embeds are provided.
usernameoptionalstring
none
Override the webhook's default display name for this message.
avatar_urloptionalstring
format uripattern ^https?://
Override the webhook's default avatar for this message.
embedsoptionalarray of objects
at most 10 items
Up to 10 embed objects to attach to the webhook message.
title (nested, level 1)string
none
Embed title shown in bold at the top.
url (nested, level 1)string
format uripattern ^https?://
URL that makes the title clickable.
description (nested, level 1)string
none
Main body text of the embed (supports Markdown).
color (nested, level 1)string
pattern ^#[0-9A-Fa-f]{6}$
Side-bar color as a hex string, e.g. '#5865F2'.
fields (nested, level 1)array of objects
none
Up to 25 name/value field blocks. Set inline:true on a field to render it side-by-side with adjacent inline fields (up to 3 per row).
name (nested, level 2)requiredstring
none
Field heading.
value (nested, level 2)requiredstring
none
Field body text.
inline (nested, level 2)boolean
none
If true, render this field side-by-side with adjacent inline fields.
author (nested, level 1)object
none
Author block shown at the top of the embed.
name (nested, level 2)requiredstring
none
Author display name.
icon_url (nested, level 2)string
format uripattern ^https?://
Small icon shown next to the author name.
url (nested, level 2)string
format uripattern ^https?://
URL the author name links to.
thumbnail_url (nested, level 1)string
format uripattern ^https?://
Small image shown in the top-right corner.
footer (nested, level 1)string
none
Footer text shown at the bottom of the embed.
image_url (nested, level 1)string
format uripattern ^https?://
Large image shown below the embed body.
timestamp (nested, level 1)boolean
none
If true, stamp the embed with the current time.

Output

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

Related tools

Also in Webhooks

Raw definition (3,181 bytes)
{
  "name": "discord_send_webhook_message",
  "description": "Send a message through a webhook using its ID and token (no bot permissions needed; the token authorizes the send). Supports per-message username/avatar overrides and up to 10 embeds. At least one of content or embeds is required. Returns the new message ID.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "webhook_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the webhook to send through."
      },
      "webhook_token": {
        "type": "string",
        "description": "Secret token of the webhook (from discord_create_webhook or discord_list_webhooks)."
      },
      "content": {
        "description": "Plain-text body of the message (max 2000 characters). Optional if embeds are provided.",
        "type": "string"
      },
      "username": {
        "description": "Override the webhook's default display name for this message.",
        "type": "string"
      },
      "avatar_url": {
        "description": "Override the webhook's default avatar for this message.",
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      },
      "embeds": {
        "description": "Up to 10 embed objects to attach to the webhook message.",
        "maxItems": 10,
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "title": {
              "description": "Embed title shown in bold at the top.",
              "type": "string"
            },
            "url": {
              "description": "URL that makes the title clickable.",
              "type": "string",
              "format": "uri",
              "pattern": "^https?://"
            },
            "description": {
              "description": "Main body text of the embed (supports Markdown).",
              "type": "string"
            },
            "color": {
              "description": "Side-bar color as a hex string, e.g. '#5865F2'.",
              "type": "string",
              "pattern": "^#[0-9A-Fa-f]{6}$"
            },
            "fields": {
              "description": "Up to 25 name/value field blocks. Set inline:true on a field to render it side-by-side with adjacent inline fields (up to 3 per row).",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Field heading."
                  },
                  "value": {
                    "type": "string",
                    "description": "Field body text."
                  },
                  "inline": {
                    "description": "If true, render this field side-by-side with adjacent inline fields.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "value"
                ],
                "additionalProperties": false
              }
            },
            "author": {
              "description": "Author block shown at the top of the embed.",
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Author display name."
                },
                "icon_url": {
                  "description": "Small icon shown next to the author name.",
                  "type": "string",
                  "format": "uri",
                  "pattern": "^https?://"
                },
                "url": {
                  "description": "URL the author name links to.",
                  "type": "string",
                  "format": "uri",
                  "pattern": "^https?://"
                }
              },
              "required": [
                "name"
              ],
              "additionalProperties": false
            },
            "thumbnail_url": {
              "description": "Small image shown in the top-right corner.",
              "type": "string",
              "format": "uri",
              "pattern": "^https?://"
            },
            "footer": {
              "description": "Footer text shown at the bottom of the embed.",
              "type": "string"
            },
            "image_url": {
              "description": "Large image shown below the embed body.",
              "type": "string",
              "format": "uri",
              "pattern": "^https?://"
            },
            "timestamp": {
              "description": "If true, stamp the embed with the current time.",
              "type": "boolean"
            }
          },
          "additionalProperties": false
        }
      }
    },
    "required": [
      "webhook_id",
      "webhook_token"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Send webhook message",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}