discord-mcp

Get reactions

discord_get_reactions

Read-only

Toolset
Messages messages
Discord permissions
View Channel and Read Message History
Context cost
342 tokens, estimated1,366 bytes of definition, divided by 4

List the users who reacted to a message with a specific emoji. Returns { reactions: [...] } with id, username, bot flag. Returns 25 users by default and at most 100, with no cursor for the rest. Super reactions are not listed. Fails when no one reacted with that emoji. Requires the View Channel and Read Message History permissions.

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
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 inspect.
emojirequiredstring
none
Unicode emoji or custom emoji 'name:id' to list reactors for.
limitoptionalinteger
1 to 100default 25
Max users to return (1–100). Default 25.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
reactionsrequiredarray of objects
id (nested, level 1)requiredstring
username (nested, level 1)requiredstring
bot (nested, level 1)requiredboolean

Related tools

Also in Messages

Raw definition (1,366 bytes)
{
  "name": "discord_get_reactions",
  "description": "List the users who reacted to a message with a specific emoji. Returns { reactions: [...] } with id, username, bot flag. Returns 25 users by default and at most 100, with no cursor for the rest. Super reactions are not listed. Fails when no one reacted with that emoji. Requires the View Channel and Read Message History permissions.",
  "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 inspect."
      },
      "emoji": {
        "type": "string",
        "description": "Unicode emoji or custom emoji 'name:id' to list reactors for."
      },
      "limit": {
        "default": 25,
        "description": "Max users to return (1–100). Default 25.",
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      }
    },
    "required": [
      "channel_id",
      "message_id",
      "emoji"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "reactions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "username": {
              "type": "string"
            },
            "bot": {
              "type": "boolean"
            }
          },
          "required": [
            "id",
            "username",
            "bot"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "reactions"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Get reactions",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}