discord-mcp

Read DMs

discord_read_dms

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-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
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.
limitoptionalinteger
1 to 100default 20
How many recent messages to fetch (1–100). Default 20.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
messagesrequiredarray of objects
id (nested, level 1)requiredstring
author (nested, level 1)requiredstring
author_id (nested, level 1)requiredstring
webhook_id (nested, level 1)string
content (nested, level 1)requiredstring
embeds (nested, level 1)requirednumber
timestamp (nested, level 1)requiredstring

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
  }
}