discord-mcp

Pin or unpin message

discord_pin_message

Write

Toolset
Messages messages
Discord permissions
Pin Messages and Read Message History
Context cost
246 tokens, estimated985 bytes of definition, divided by 4

Pin or unpin a message in a channel, controlled by the pin flag. Requires the Pin Messages and Read Message History permissions (Pin Messages is a dedicated permission since early 2026, separate from Manage Messages). A channel holds at most 250 pins. Idempotent: pinning an already-pinned message (or unpinning an unpinned one) has no additional effect.

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
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel or thread containing the message.
message_idrequiredstring
pattern ^\d{17,20}$
ID of the message to pin or unpin.
pinrequiredboolean
none
true to pin the message, false to unpin it.

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 Messages

Raw definition (985 bytes)
{
  "name": "discord_pin_message",
  "description": "Pin or unpin a message in a channel, controlled by the pin flag. Requires the Pin Messages and Read Message History permissions (Pin Messages is a dedicated permission since early 2026, separate from Manage Messages). A channel holds at most 250 pins. Idempotent: pinning an already-pinned message (or unpinning an unpinned one) has no additional effect.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel or thread containing the message."
      },
      "message_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID of the message to pin or unpin."
      },
      "pin": {
        "type": "boolean",
        "description": "true to pin the message, false to unpin it."
      }
    },
    "required": [
      "channel_id",
      "message_id",
      "pin"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Pin or unpin message",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}