Discord Automation Agent Skill

Discord Automation via Rube MCP

Automate Discord operations through Composio's Discord/Discordbot toolkits via Rube MCP.

Toolkit docs: composio.dev/toolkits/discord

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 |

*Powered by Composio*