discord-mcp

Edit DM embed

discord_edit_dm_embed

Write

Toolset
Direct messages dm
Context cost
700 tokens, estimated2,801 bytes of definition, divided by 4

Replace the embed on a DM message previously sent by this bot. Full replace, not merge: provided fields are applied and omitted fields are dropped. Omitting content, or passing an empty string, keeps the message's current text; this tool cannot clear it. Use discord_edit_dm to change only the text, or discord_edit_embed for a message in a server channel. Returns a confirmation.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintyesRepeating the call with the same arguments has no 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
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the DM recipient.
message_idrequiredstring
pattern ^\d{17,20}$
ID of the target message within the DM conversation.
contentoptionalstring
none
Optional new plain text shown above the embed.
titleoptionalstring
none
Embed title shown in bold at the top.
urloptionalstring
format uripattern ^https?://
URL that makes the title clickable.
descriptionoptionalstring
none
Main body text of the embed (supports Markdown).
coloroptionalstring
pattern ^#[0-9A-Fa-f]{6}$
Side-bar color as a hex string, e.g. '#5865F2'.
fieldsoptionalarray 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 1)requiredstring
none
Field heading.
value (nested, level 1)requiredstring
none
Field body text.
inline (nested, level 1)boolean
none
If true, render this field side-by-side with adjacent inline fields.
authoroptionalobject
none
Author block shown at the top of the embed.
name (nested, level 1)requiredstring
none
Author display name.
icon_url (nested, level 1)string
format uripattern ^https?://
Small icon shown next to the author name.
url (nested, level 1)string
format uripattern ^https?://
URL the author name links to.
thumbnail_urloptionalstring
format uripattern ^https?://
Small image shown in the top-right corner.
footeroptionalstring
none
Footer text shown at the bottom of the embed.
image_urloptionalstring
format uripattern ^https?://
Large image shown below the embed body.
timestampoptionalboolean
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

Named in its description

Also in Direct messages

Raw definition (2,801 bytes)
{
  "name": "discord_edit_dm_embed",
  "description": "Replace the embed on a DM message previously sent by this bot. Full replace, not merge: provided fields are applied and omitted fields are dropped. Omitting content, or passing an empty string, keeps the message's current text; this tool cannot clear it. Use discord_edit_dm to change only the text, or discord_edit_embed for a message in a server channel. Returns a confirmation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the DM recipient."
      },
      "message_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID of the target message within the DM conversation."
      },
      "content": {
        "description": "Optional new plain text shown above the embed.",
        "type": "string"
      },
      "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"
      }
    },
    "required": [
      "user_id",
      "message_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit DM embed",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}