Read DMs
discord_
Read-only
- Toolset
- Direct messages
dm - Context cost
- 280 tokens, estimated1,121 bytes of definition, divided by 4
Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. Returns { messages: [...] } with id, author, content, embed count, timestamp. Read-only.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
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. |
| limitoptional | integer | 1 to 100default 20 | How many recent messages to fetch (1–100). Default 20. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| messagesrequired | array of objects |
| id (nested, level 1)required | string |
| author (nested, level 1)required | string |
| author_ | string |
| webhook_ | string |
| content (nested, level 1)required | string |
| embeds (nested, level 1)required | number |
| timestamp (nested, level 1)required | string |
Related tools
Also in Direct messages
Raw definition (1,121 bytes)
{
"name": "discord_read_dms",
"description": "Read the most recent messages from the bot's DM conversation with a user, oldest-to-newest. Returns { messages: [...] } with id, author, content, embed count, timestamp. Read-only.",
"inputSchema": {
"type": "object",
"properties": {
"user_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord user ID (snowflake) of the DM recipient."
},
"limit": {
"default": 20,
"description": "How many recent messages to fetch (1–100). Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"user_id"
],
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"author": {
"type": "string"
},
"author_id": {
"type": "string"
},
"webhook_id": {
"type": "string"
},
"content": {
"type": "string"
},
"embeds": {
"type": "number"
},
"timestamp": {
"type": "string"
}
},
"required": [
"id",
"author",
"author_id",
"content",
"embeds",
"timestamp"
],
"additionalProperties": false
}
}
},
"required": [
"messages"
],
"additionalProperties": false
},
"annotations": {
"title": "Read DMs",
"readOnlyHint": true,
"openWorldHint": true
}
}