discord-mcp

Timeout member

discord_timeout_member

Write

Toolset
Members members
Discord permission
Moderate Members
Context cost
284 tokens, estimated1,134 bytes of definition, divided by 4

Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission. Discord refuses to time out the server owner or a member with Administrator.

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
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the member to time out.
duration_minutesrequiredinteger
0 to 40320
Timeout length in minutes (0–40320, i.e. up to 28 days). Use 0 to clear an existing timeout.
reasonoptionalstring
none
Optional reason recorded in the server audit log.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Also in Members

Raw definition (1,134 bytes)
{
  "name": "discord_timeout_member",
  "description": "Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission. Discord refuses to time out the server owner or a member with Administrator.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the member to time out."
      },
      "duration_minutes": {
        "type": "integer",
        "minimum": 0,
        "maximum": 40320,
        "description": "Timeout length in minutes (0–40320, i.e. up to 28 days). Use 0 to clear an existing timeout."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "guild_id",
      "user_id",
      "duration_minutes"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Timeout member",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}