Discord

Typical Workflow

1. Discover guilds → discord_guilds (list all the bot is in, or pass guild_id for one)
2. Discover channels → discord_channels with guild_id (list text channels, or pass channel_id for one)
3. Read messages → discord_messages with channel_id
4. Post a message → discord_post_message with channel_id + content
5. Reply to a message → discord_reply_to_message with channel_id + message_id + content
6. React → discord_add_reaction with channel_id + message_id + emoji
7. Look up members → discord_members with guild_id (list all, or pass user_id for one)

Key Concepts

• Guild = a Discord server. The bot is added to a guild when the user authorizes via OAuth.
• Channel IDs are snowflake strings (e.g. 1234567890123456789).
• Message IDs are also snowflakes, used for replies and reactions.
• Threads are channels with a parent_id — use discord_messages with the thread's channel_id.
• Snowflake pagination: use before / after message IDs instead of cursors.
• Reactions use emoji characters (👍, ❤️, 🔥) or name:id for custom emoji.

Thread Management

• Create a thread from an existing message → discord_create_thread with channel_id + message_id + name.
• Create a standalone thread → discord_create_thread with channel_id + name (no message_id).
• Read/post in threads → threads have their own channel_id. Use discord_messages and discord_post_message with the thread's channel_id.

Message Management

• Edit the bot's own messages → discord_edit_message with channel_id + message_id + new content.
• Delete messages → discord_delete_message (bot's own always, others' with MANAGE_MESSAGES).
• Pin/Unpin → discord_pin_message / discord_unpin_message (needs MANAGE_MESSAGES).
• Read pins → discord_pinned_messages — read these first for channel context.

Gotchas

• Rate limit: 50 requests/second globally, per-route limits vary. Respect Retry-After headers.
• Emoji for reactions: use the Unicode character directly. Custom emoji use name:id format.
• No search API: Discord does not expose a message search endpoint. Read specific channels instead.
• MESSAGE_CONTENT intent: Must be enabled in the Developer Portal for the bot to read message content.
• Server Members intent: Must be enabled for listing guild members.
• Max 50 pins per channel: Discord enforces this limit.