Discord MCP - Discord server management MCP for AI agents

Send message

send_message

Posts a message to a Discord channel with text, embeds, files, or a Components V2 layout, optionally as a reply, and can preview the result with dry_run before sending.

Instructions

Send a message to a channel, optionally as a reply, with embeds, or as a Components V2 layout of text, sections, image galleries, separators and link buttons inside colored containers, and with up to 10 files fetched from public URLs. Components replace content and embeds rather than joining them, and the choice is permanent for that message; in a layout, a file shows only where a gallery or thumbnail points at it as attachment://. For a private message to one person use send_dm; to post under a custom name and avatar use send_webhook_message; to send later use schedule_message. Mentions are suppressed by default; raise the mentions mode only deliberately. Supports dry_run.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "channel": "<channel>"
    },
    "name": "send_message"
  }
}

Input Schema

Name	Required	Description
`files`	No	Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.
`guild`	No	Guild (server) name or ID. Omit to use the default guild.
`embeds`	No	Up to 10 embeds. Each needs a title, a description, an author, fields, a footer, or a picture. Discord allows 6,000 characters of text across all of one message's embeds.
`silent`	No	Send without triggering notifications.
`channel`	Yes	Channel name or ID.
`content`	No	Message text. May be left out when embeds, files, or components carry the message.
`dry_run`	No	Preview without sending.
`mentions`	No	Which mention types may ping. Default none.
`reply_to`	No	Message to reply to: its ID or link.
`components`	No	Rich layout, in place of content and embeds. Sending this sets the Components V2 flag, which is permanent for that message: it can never show plain content or embeds afterward, so the two cannot be combined.

Schema Changelog

Changes observed during successful MCP inspections.

Changed17 schema fields changedv1.4.2Nov 12, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedInput schema / properties / components / items / properties / components / items / properties / media / items / properties / url / description
```
Previous value: -"Public image URL."New value: +"Public image URL, or attachment://<filename> for a file sent with the message."
```

changedInput schema / properties / components / items / properties / media / items / properties / url / description

Previous value: -"Public image URL."New value: +"Public image URL, or attachment://<filename> for a file sent with the message."

changedInput schema / properties / content / description

Previous value: -"Message text. Required unless components is used."New value: +"Message text. May be left out when embeds, files, or components carry the message."

changedInput schema / properties / embeds / description

Previous value: -"Up to 10 embeds."New value: +"Up to 10 embeds. Each needs a title, a description, an author, fields, a footer, or a picture. Discord allows 6,000 characters of text across all of one message's embeds."

addedInput schema / properties / embeds / items / additionalProperties
```
Added value: +false
```

addedInput schema / properties / embeds / items / properties / author

Added value: +{
+  "description": "Small line above the title, such as who it is from.",
+  "maxLength": 256,
+  "type": "string"
+}

addedInput schema / properties / embeds / items / properties / fields

Added value: +{
+  "description": "Up to 25 name and value pairs under the description.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "inline": {
+        "description": "Sits beside its neighbours instead of on a row of its own.",
+        "type": "boolean"
+      },
+      "name": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "value": {
+        "maxLength": 1024,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "value"
+    ],
+    "type": "object"
+  },
+  "maxItems": 25,
+  "type": "array"
+}

addedInput schema / properties / embeds / items / properties / footer

Added value: +{
+  "description": "Small line at the bottom.",
+  "maxLength": 2048,
+  "type": "string"
+}

addedInput schema / properties / embeds / items / properties / image_url

Added value: +{
+  "description": "Large picture under the text: an http or https link, or attachment://<filename> for a file that comes with the message.",
+  "maxLength": 2048,
+  "pattern": "^(https?|attachment):\\/\\/\\S+$",
+  "type": "string"
+}

addedInput schema / properties / embeds / items / properties / thumbnail_url

Added value: +{
+  "description": "Small picture in the top corner, given the same way.",
+  "maxLength": 2048,
+  "pattern": "^(https?|attachment):\\/\\/\\S+$",
+  "type": "string"
+}

addedInput schema / properties / embeds / items / properties / timestamp

Added value: +{
+  "description": "A time shown beside the footer: \"now\" for the current time, or ISO 8601, like 2026-11-09T18:00:00Z. With no zone it is read as UTC.",
+  "type": "string"
+}

addedInput schema / properties / embeds / items / properties / url / description
```
Added value: +"Makes the title a link."
```
removedInput schema / properties / embeds / items / properties / url / format
```
Removed value: -"uri"
```
addedInput schema / properties / embeds / items / properties / url / pattern
```
Added value: +"^https?:\\/\\/"
```

addedInput schema / properties / files

Added value: +{
+  "description": "Up to 10 files to attach, each fetched from a public URL (20 MiB each). Needs the Attach Files permission.",
+  "items": {
+    "properties": {
+      "description": {
+        "description": "Alt text describing the file, read by screen readers.",
+        "maxLength": 1024,
+        "type": "string"
+      },
+      "filename": {
+        "description": "Name to show, such as chart.png. Default: taken from the URL.",
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "spoiler": {
+        "description": "Blur it until clicked.",
+        "type": "boolean"
+      },
+      "url": {
+        "description": "Public http or https URL of the file. Local paths are not accepted.",
+        "format": "uri",
+        "type": "string"
+      }
+    },
+    "required": [
+      "url"
+    ],
+    "type": "object"
+  },
+  "maxItems": 10,
+  "minItems": 1,
+  "type": "array"
+}

changedInput schema / properties / reply_to / description

Previous value: -"Message ID to reply to."New value: +"Message to reply to: its ID or link."

Changed3 schema fields changedv1.4.0Sep 14, 2026

addedInput schema / properties / components

Added value: +{
+  "description": "Rich layout, in place of content and embeds. Sending this sets the Components V2 flag, which is permanent for that message: it can never show plain content or embeds afterward, so the two cannot be combined.",
+  "items": {
+    "properties": {
+      "accent_color": {
+        "description": "For container, hex color of the left edge, like #5865f2.",
+        "type": "string"
+      },
+      "buttons": {
+        "description": "For buttons, 1-5 link buttons on one row. For section, exactly one. Link buttons only: this server does not answer interactions, so a button that fires one would fail for whoever clicked it.",
+        "items": {
+          "properties": {
+            "disabled": {
+              "type": "boolean"
+            },
+            "label": {
+              "description": "Button text.",
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            "url": {
+              "description": "Where the button leads.",
+              "format": "uri",
+              "maxLength": 512,
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "url"
+          ],
+          "type": "object"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "components": {
+        "description": "For container, the 1-10 blocks inside it.",
+        "items": {
+          "properties": {
+            "buttons": {
+              "items": {
+                "properties": {
+                  "disabled": {
+                    "type": "boolean"
+                  },
+                  "label": {
+                    "description": "Button text.",
+                    "maxLength": 80,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "url": {
+                    "description": "Where the button leads.",
+                    "format": "uri",
+                    "maxLength": 512,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "label",
+                  "url"
+                ],
+                "type": "object"
+              },
+              "maxItems": 5,
+              "minItems": 1,
+              "type": "array"
+            },
+            "divider": {
+              "type": "boolean"
+            },
+            "media": {
+              "items": {
+                "properties": {
+                  "description": {
+                    "description": "Alt text.",
+                    "maxLength": 1024,
+                    "type": "string"
+                  },
+                  "spoiler": {
+                    "description": "Blur until clicked.",
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "description": "Public image URL.",
+                    "format": "uri",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url"
+                ],
+                "type": "object"
+              },
+              "maxItems": 10,
+              "minItems": 1,
+              "type": "array"
+            },
+            "spacing": {
+              "enum": [
+                "small",
+                "large"
+              ],
+              "type": "string"
+            },
+            "text": {
+              "maxLength": 4000,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": {
+              "description": "Same block types as above, except container.",
+              "enum": [
+                "text",
+                "section",
+                "gallery",
+                "separator",
+                "buttons"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "type": "object"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      },
+      "divider": {
+        "description": "For separator, draw a horizontal rule. Default true.",
+        "type": "boolean"
+      },
+      "media": {
+        "description": "For gallery, 1-10 images. For section, exactly one, shown as a thumbnail on the right.",
+        "items": {
+          "properties": {
+            "description": {
+              "description": "Alt text.",
+              "maxLength": 1024,
+              "type": "string"
+            },
+            "spoiler": {
+              "description": "Blur until clicked.",
+              "type": "boolean"
+            },
+            "url": {
+              "description": "Public image URL.",
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "required": [
+            "url"
+          ],
+          "type": "object"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      },
+      "spacing": {
+        "description": "For separator, how much padding. Default small.",
+        "enum": [
+          "small",
+          "large"
+        ],
+        "type": "string"
+      },
+      "spoiler": {
+        "description": "For container, blur the whole group until clicked.",
+        "type": "boolean"
+      },
+      "text": {
+        "description": "Markdown body. Required for text and section.",
+        "maxLength": 4000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "description": "text: a paragraph of markdown. section: text with a thumbnail or link button beside it. gallery: 1-10 images. separator: vertical space, optionally a rule. buttons: a row of link buttons. container: a bordered group with a colored edge.",
+        "enum": [
+          "text",
+          "section",
+          "gallery",
+          "separator",
+          "buttons",
+          "container"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  "maxItems": 40,
+  "minItems": 1,
+  "type": "array"
+}

changedInput schema / properties / content / description

Previous value: -"Message text."New value: +"Message text. Required unless components is used."

changedInput schema / required

Previous value: -[
-  "channel",
-  "content"
-]New value: +[
+  "channel"
+]

Changed2 schema fields changedv1.3.0Aug 12, 2026
- removedInput schema / additionalProperties
```
Removed value: -false
```
- removedInput schema / properties / embeds / items / additionalProperties
```
Removed value: -false
```
First observedv1.0.2Jun 14, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say this is a non-read-only, non-destructive write. The description adds real behavioral facts beyond that: sending components sets a permanent Components V2 flag so plain content and embeds can never be added afterward, and files only render in a layout where a gallery or thumbnail points at them via attachment://<filename>. It also flags the irreversible choice and the mention suppression default, though it does not discuss rate limits or per-channel permission failures.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with the core action and routing, and nearly every sentence carries a constraint that affects correctness. The opening sentence is overloaded, packing the reply/embed/component modes into one long clause, but no sentence is filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter tool with deeply nested components, the description covers the high-risk rules: mode exclusivity, permanence, mention defaults, and dry_run. The main gap is return behavior, since there is no output schema and the description never says whether a message ID comes back (which an agent would need for reply_to or follow-up edits).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description adds cross-parameter semantics the schema cannot express: components replace rather than join content/embeds, and the attachment:// reference rule governs how files and media parameters interact. That is genuine value beyond the per-field descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence gives a specific verb and resource (send a message to a channel) and immediately enumerates the three payload modes: reply, embeds, and Components V2 layouts. It explicitly separates itself from send_dm, send_webhook_message, and schedule_message, so an agent can pick this tool without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It names three alternative tools with the exact condition that selects each (private message, custom name/avatar, later delivery). It also gives operational guidance in-line: mentions are suppressed by default and should be raised deliberately, and components must not be combined with content or embeds.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server