discord-mcp

Send DM

discord_send_dm

Write

Toolset
Direct messages dm
Context cost
195 tokens, estimated780 bytes of definition, divided by 4

Send a private direct message to a user by their user ID. Use discord_send_message to post in a server channel instead. Requires the bot to share at least one server with the user, and the user must allow DMs from server members (otherwise Discord rejects the send). 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
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the DM recipient.
contentrequiredstring
none
Plain-text body of the DM (max 2000 characters).

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 (780 bytes)
{
  "name": "discord_send_dm",
  "description": "Send a private direct message to a user by their user ID. Use discord_send_message to post in a server channel instead. Requires the bot to share at least one server with the user, and the user must allow DMs from server members (otherwise Discord rejects the send). Returns the new message ID.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the DM recipient."
      },
      "content": {
        "type": "string",
        "description": "Plain-text body of the DM (max 2000 characters)."
      }
    },
    "required": [
      "user_id",
      "content"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Send DM",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}