name: discord-automation
description: "Automate Discord tasks via Rube MCP (Composio): messages, channels, roles, webhooks, reactions. Always search tools first for current schemas."
Discord Automation via Rube MCP
Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Discord connection via
RUBE_MANAGE_CONNECTIONS with toolkits discord and discordbot
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit discordbot (bot operations) or discord (user operations)
- If connection is not ACTIVE, follow the returned auth link to complete Discord auth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Send Messages
When to use: User wants to send messages to channels or DMs
Tool sequence:
DISCORD_LIST_MY_GUILDS - List guilds the bot belongs to [Prerequisite]
DISCORDBOT_LIST_GUILD_CHANNELS - List channels in a guild [Prerequisite]
DISCORDBOT_CREATE_MESSAGE - Send a message [Required]
DISCORDBOT_UPDATE_MESSAGE - Edit a sent message [Optional]
Key parameters:
channel_id: Channel snowflake ID
content: Message text (max 2000 characters)
embeds: Array of embed objects for rich content
guild_id: Guild ID for channel listing
Pitfalls:
- Bot must have SEND_MESSAGES permission in the channel
- High-frequency sends can hit per-route rate limits; respect Retry-After headers
- Only messages sent by the same bot can be edited
2. Send Direct Messages
When to use: User wants to DM a Discord user
Tool sequence:
DISCORDBOT_CREATE_DM - Create or get DM channel [Required]
DISCORDBOT_CREATE_MESSAGE - Send message to DM channel [Required]
Key parameters:
recipient_id: User snowflake ID for DM
channel_id: DM channel ID from CREATE_DM
Pitfalls:
- Cannot DM users who have DMs disabled or have blocked the bot
- CREATE_DM returns existing channel if one already exists
3. Manage Roles
When to use: User wants to create, assign, or remove roles
Tool sequence:
DISCORDBOT_CREATE_GUILD_ROLE - Create a new role [Optional]
DISCORDBOT_ADD_GUILD_MEMBER_ROLE - Assign role to member [Optional]
DISCORDBOT_DELETE_GUILD_ROLE - Delete a role [Optional]
DISCORDBOT_GET_GUILD_MEMBER - Get member details [Optional]
DISCORDBOT_UPDATE_GUILD_MEMBER - Update member (roles, nick, etc.) [Optional]
Key parameters:
guild_id: Guild snowflake ID
user_id: User snowflake ID
role_id: Role snowflake ID
name: Role name
permissions: Bitwise permission value
color: RGB color integer
Pitfalls:
- Role assignment requires MANAGE_ROLES permission
- Target role must be lower in hierarchy than bot's highest role
- DELETE permanently removes the role from all members
4. Manage Webhooks
When to use: User wants to create or use webhooks for external integrations
Tool sequence:
DISCORDBOT_GET_GUILD_WEBHOOKS / DISCORDBOT_LIST_CHANNEL_WEBHOOKS - List webhooks [Optional]
DISCORDBOT_CREATE_WEBHOOK - Create a new webhook [Optional]
DISCORDBOT_EXECUTE_WEBHOOK - Send message via webhook [Optional]
DISCORDBOT_UPDATE_WEBHOOK - Update webhook settings [Optional]
Key parameters:
webhook_id: Webhook ID
webhook_token: Webhook secret token
channel_id: Channel for webhook creation
name: Webhook name
content/embeds: Message content for execution
Pitfalls:
- Webhook tokens are secrets; handle securely
- Webhooks can post with custom username and avatar per message
- MANAGE_WEBHOOKS permission required for creation
5. Manage Reactions
When to use: User wants to view or manage message reactions
Tool sequence:
DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI - List users who reacted [Optional]
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS - Remove all reactions [Optional]
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI - Remove specific emoji reactions [Optional]
DISCORDBOT_DELETE_USER_MESSAGE_REACTION - Remove specific user's reaction [Optional]
Key parameters:
channel_id: Channel ID
message_id: Message snowflake ID
emoji_name: URL-encoded emoji or name:id for custom emojis
user_id: User ID for specific reaction removal
Pitfalls:
- Unicode emojis must be URL-encoded (e.g., '%F0%9F%91%8D' for thumbs up)
- Custom emojis use
name:id format
- DELETE_ALL requires MANAGE_MESSAGES permission
Common Patterns
Snowflake IDs
Discord uses snowflake IDs (64-bit integers as strings) for all entities:
- Guilds, channels, users, roles, messages, webhooks
Permission Bitfields
Permissions are combined using bitwise OR:
- SEND_MESSAGES = 0x800
- MANAGE_ROLES = 0x10000000
- MANAGE_MESSAGES = 0x2000
- ADMINISTRATOR = 0x8
Pagination
- Most list endpoints support
limit, before, after parameters
- Messages: max 100 per request
- Reactions: max 100 per request, use
after for pagination
Known Pitfalls
Bot vs User Tokens:
discordbot toolkit uses bot tokens; discord uses user OAuth
- Bot operations are preferred for automation
Rate Limits:
- Discord enforces per-route rate limits
- Respect
Retry-After headers on 429 responses
Quick Reference
| Task |
Tool Slug |
Key Params |
| List guilds |
DISCORD_LIST_MY_GUILDS |
(none) |
| List channels |
DISCORDBOT_LIST_GUILD_CHANNELS |
guild_id |
| Send message |
DISCORDBOT_CREATE_MESSAGE |
channel_id, content |
| Edit message |
DISCORDBOT_UPDATE_MESSAGE |
channel_id, message_id |
| Get messages |
DISCORDBOT_LIST_MESSAGES |
channel_id, limit |
| Create DM |
DISCORDBOT_CREATE_DM |
recipient_id |
| Create role |
DISCORDBOT_CREATE_GUILD_ROLE |
guild_id, name |
| Assign role |
DISCORDBOT_ADD_GUILD_MEMBER_ROLE |
guild_id, user_id, role_id |
| Delete role |
DISCORDBOT_DELETE_GUILD_ROLE |
guild_id, role_id |
| Get member |
DISCORDBOT_GET_GUILD_MEMBER |
guild_id, user_id |
| Update member |
DISCORDBOT_UPDATE_GUILD_MEMBER |
guild_id, user_id |
| Get guild |
DISCORDBOT_GET_GUILD |
guild_id |
| Create webhook |
DISCORDBOT_CREATE_WEBHOOK |
channel_id, name |
| Execute webhook |
DISCORDBOT_EXECUTE_WEBHOOK |
webhook_id, webhook_token |
| List webhooks |
DISCORDBOT_GET_GUILD_WEBHOOKS |
guild_id |
| Get reactions |
DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI |
channel_id, message_id, emoji_name |
| Clear reactions |
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS |
channel_id, message_id |
| Test auth |
DISCORDBOT_TEST_AUTH |
(none) |
| Get channel |
DISCORDBOT_GET_CHANNEL |
channel_id |
1---2name: discord-automation-33description: <!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->4---5<!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->6---7name: discord-automation8description: "Automate Discord tasks via Rube MCP (Composio): messages, channels, roles, webhooks, reactions. Always search tools first for current schemas."9---1011# Discord Automation via Rube MCP1213Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.1415## Prerequisites1617- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)18- Active Discord connection via `RUBE_MANAGE_CONNECTIONS` with toolkits `discord` and `discordbot`19- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2021## Setup2223**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2425261. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds272. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `discordbot` (bot operations) or `discord` (user operations)283. If connection is not ACTIVE, follow the returned auth link to complete Discord auth294. Confirm connection status shows ACTIVE before running any workflows3031## Core Workflows3233### 1. Send Messages3435**When to use**: User wants to send messages to channels or DMs3637**Tool sequence**:381. `DISCORD_LIST_MY_GUILDS` - List guilds the bot belongs to [Prerequisite]392. `DISCORDBOT_LIST_GUILD_CHANNELS` - List channels in a guild [Prerequisite]403. `DISCORDBOT_CREATE_MESSAGE` - Send a message [Required]414. `DISCORDBOT_UPDATE_MESSAGE` - Edit a sent message [Optional]4243**Key parameters**:44- `channel_id`: Channel snowflake ID45- `content`: Message text (max 2000 characters)46- `embeds`: Array of embed objects for rich content47- `guild_id`: Guild ID for channel listing4849**Pitfalls**:50- Bot must have SEND_MESSAGES permission in the channel51- High-frequency sends can hit per-route rate limits; respect Retry-After headers52- Only messages sent by the same bot can be edited5354### 2. Send Direct Messages5556**When to use**: User wants to DM a Discord user5758**Tool sequence**:591. `DISCORDBOT_CREATE_DM` - Create or get DM channel [Required]602. `DISCORDBOT_CREATE_MESSAGE` - Send message to DM channel [Required]6162**Key parameters**:63- `recipient_id`: User snowflake ID for DM64- `channel_id`: DM channel ID from CREATE_DM6566**Pitfalls**:67- Cannot DM users who have DMs disabled or have blocked the bot68- CREATE_DM returns existing channel if one already exists6970### 3. Manage Roles7172**When to use**: User wants to create, assign, or remove roles7374**Tool sequence**:751. `DISCORDBOT_CREATE_GUILD_ROLE` - Create a new role [Optional]762. `DISCORDBOT_ADD_GUILD_MEMBER_ROLE` - Assign role to member [Optional]773. `DISCORDBOT_DELETE_GUILD_ROLE` - Delete a role [Optional]784. `DISCORDBOT_GET_GUILD_MEMBER` - Get member details [Optional]795. `DISCORDBOT_UPDATE_GUILD_MEMBER` - Update member (roles, nick, etc.) [Optional]8081**Key parameters**:82- `guild_id`: Guild snowflake ID83- `user_id`: User snowflake ID84- `role_id`: Role snowflake ID85- `name`: Role name86- `permissions`: Bitwise permission value87- `color`: RGB color integer8889**Pitfalls**:90- Role assignment requires MANAGE_ROLES permission91- Target role must be lower in hierarchy than bot's highest role92- DELETE permanently removes the role from all members9394### 4. Manage Webhooks9596**When to use**: User wants to create or use webhooks for external integrations9798**Tool sequence**:991. `DISCORDBOT_GET_GUILD_WEBHOOKS` / `DISCORDBOT_LIST_CHANNEL_WEBHOOKS` - List webhooks [Optional]1002. `DISCORDBOT_CREATE_WEBHOOK` - Create a new webhook [Optional]1013. `DISCORDBOT_EXECUTE_WEBHOOK` - Send message via webhook [Optional]1024. `DISCORDBOT_UPDATE_WEBHOOK` - Update webhook settings [Optional]103104**Key parameters**:105- `webhook_id`: Webhook ID106- `webhook_token`: Webhook secret token107- `channel_id`: Channel for webhook creation108- `name`: Webhook name109- `content`/`embeds`: Message content for execution110111**Pitfalls**:112- Webhook tokens are secrets; handle securely113- Webhooks can post with custom username and avatar per message114- MANAGE_WEBHOOKS permission required for creation115116### 5. Manage Reactions117118**When to use**: User wants to view or manage message reactions119120**Tool sequence**:1211. `DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI` - List users who reacted [Optional]1222. `DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS` - Remove all reactions [Optional]1233. `DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI` - Remove specific emoji reactions [Optional]1244. `DISCORDBOT_DELETE_USER_MESSAGE_REACTION` - Remove specific user's reaction [Optional]125126**Key parameters**:127- `channel_id`: Channel ID128- `message_id`: Message snowflake ID129- `emoji_name`: URL-encoded emoji or `name:id` for custom emojis130- `user_id`: User ID for specific reaction removal131132**Pitfalls**:133- Unicode emojis must be URL-encoded (e.g., '%F0%9F%91%8D' for thumbs up)134- Custom emojis use `name:id` format135- DELETE_ALL requires MANAGE_MESSAGES permission136137## Common Patterns138139### Snowflake IDs140141Discord uses snowflake IDs (64-bit integers as strings) for all entities:142- Guilds, channels, users, roles, messages, webhooks143144### Permission Bitfields145146Permissions are combined using bitwise OR:147- SEND_MESSAGES = 0x800148- MANAGE_ROLES = 0x10000000149- MANAGE_MESSAGES = 0x2000150- ADMINISTRATOR = 0x8151152### Pagination153154- Most list endpoints support `limit`, `before`, `after` parameters155- Messages: max 100 per request156- Reactions: max 100 per request, use `after` for pagination157158## Known Pitfalls159160**Bot vs User Tokens**:161- `discordbot` toolkit uses bot tokens; `discord` uses user OAuth162- Bot operations are preferred for automation163164**Rate Limits**:165- Discord enforces per-route rate limits166- Respect `Retry-After` headers on 429 responses167168## Quick Reference169170| Task | Tool Slug | Key Params |171|------|-----------|------------|172| List guilds | DISCORD_LIST_MY_GUILDS | (none) |173| List channels | DISCORDBOT_LIST_GUILD_CHANNELS | guild_id |174| Send message | DISCORDBOT_CREATE_MESSAGE | channel_id, content |175| Edit message | DISCORDBOT_UPDATE_MESSAGE | channel_id, message_id |176| Get messages | DISCORDBOT_LIST_MESSAGES | channel_id, limit |177| Create DM | DISCORDBOT_CREATE_DM | recipient_id |178| Create role | DISCORDBOT_CREATE_GUILD_ROLE | guild_id, name |179| Assign role | DISCORDBOT_ADD_GUILD_MEMBER_ROLE | guild_id, user_id, role_id |180| Delete role | DISCORDBOT_DELETE_GUILD_ROLE | guild_id, role_id |181| Get member | DISCORDBOT_GET_GUILD_MEMBER | guild_id, user_id |182| Update member | DISCORDBOT_UPDATE_GUILD_MEMBER | guild_id, user_id |183| Get guild | DISCORDBOT_GET_GUILD | guild_id |184| Create webhook | DISCORDBOT_CREATE_WEBHOOK | channel_id, name |185| Execute webhook | DISCORDBOT_EXECUTE_WEBHOOK | webhook_id, webhook_token |186| List webhooks | DISCORDBOT_GET_GUILD_WEBHOOKS | guild_id |187| Get reactions | DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI | channel_id, message_id, emoji_name |188| Clear reactions | DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS | channel_id, message_id |189| Test auth | DISCORDBOT_TEST_AUTH | (none) |190| Get channel | DISCORDBOT_GET_CHANNEL | channel_id |191192<!-- Source: .faos/custom/skills/devops/discord-automation/SKILL.md -->