Get reactions
discord_
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-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 |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel or thread containing the message. |
| message_ | string | pattern ^\d{17,20}$ | ID of the message to inspect. |
| emojirequired | string | none | Unicode emoji or custom emoji 'name:id' to list reactors for. |
| limitoptional | integer | 1 to 100default 25 | Max users to return (1–100). Default 25. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| reactionsrequired | array of objects |
| id (nested, level 1)required | string |
| username (nested, level 1)required | string |
| bot (nested, level 1)required | boolean |
Related tools
Also in Messages
-
Read messages, Read-only
discord_read_ messages -
Send message, Write
discord_send_ message -
Reply to message, Write
discord_reply_ message -
Edit message, Write
discord_edit_ message -
Add reaction, Write
discord_add_ reaction -
List channel threads, Read-only
discord_list_ channel_ threads -
Create thread, Write
discord_create_ thread -
Bulk delete messages, Destructive
discord_bulk_ delete_ messages -
Send embed, Write
discord_send_ embed -
Edit embed, Write
discord_edit_ embed -
Send multiple embeds, Write
discord_send_ multiple_ embeds -
Delete message, Destructive
discord_delete_ message -
Pin or unpin message, Write
discord_pin_ message -
Search messages, Read-only
discord_search_ messages -
Search guild messages, Read-only
discord_search_ guild_ messages -
Crosspost message, Write
discord_crosspost_ message -
Remove reactions, Destructive
discord_remove_ reactions -
Get message attachments, Read-only
discord_get_ message_ attachments -
Fetch pinned messages, Read-only
discord_fetch_ pinned_ messages -
Forward message, Write
discord_forward_ message
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
}
}