Send DM
discord_
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_ 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-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| user_ | string | pattern ^\d{17,20}$ | Discord user ID (snowflake) of the DM recipient. |
| contentrequired | string | 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
}
}