Messaging and channels: 44 tools across 5 categories
Writes to Discord are not automatically safe. Check the annotation on each tool, only tools marked Confirmation required participate in the __confirm and dry-run gate described in how it works, ordinary writes can execute on the first call.
Messages (12 tools)#
Send, edit, pin, search, and manage messages in a channel.
messages_send (write), messages_edit (write), messages_get (read), messages_read (read - recent messages), messages_search_recent (read), messages_pin / messages_unpin (write), messages_list_pins (read), messages_create_thread (write - start a public thread from a message), messages_crosspost (write - publish from an Announcement channel), messages_bulk_delete (write, destructive, 2-100 messages in one request, irreversible), messages_delete (write, destructive, irreversible).
Channels (14 tools)#
Create, configure, and inspect guild channels, forum threads, and permission overwrites.
channels_list / channels_get (read), channels_create_guild_channel (write - text, voice, category, announcement, or forum), channels_modify (write - partial update), channels_delete (write, destructive, irreversible), channels_modify_permissions / channels_delete_permissions (write - role/user overwrites), channels_follow_announcement (write - cross-post via webhook), channels_forum_create_thread (write), channels_trigger_typing (write), plus three archived-thread listing tools (list_active_threads_guild, list_public_archived_threads, list_private_archived_threads, list_joined_private_archived_threads, all read-only).
Threads (6 tools)#
Manage thread membership: threads_join, threads_leave, threads_add_member, threads_remove_member (all write), threads_get_member / threads_list_members (read).
Reactions (5 tools)#
reactions_create (write), reactions_list (read), reactions_delete_own / reactions_delete_user (write), reactions_delete_all (write, destructive).
Webhooks (13 tools)#
Provision channel-bound publishing identities that don't consume your bot's rate-limit bucket. See publish as a webhook for a full worked recipe.
webhooks_create (write), webhooks_get / webhooks_get_with_token (read - the token variant needs no bot auth), webhooks_list_channel / webhooks_list_guild (read), webhooks_modify / webhooks_modify_with_token (write), webhooks_execute (write - the low-level send escape hatch), webhooks_get_message / webhooks_edit_message (read/write on a webhook's own message), webhooks_delete / webhooks_delete_with_token / webhooks_delete_message (write, destructive, irreversible).
Polls (2 tools)#
polls_end (write) and polls_get_voters (read).
Related#
For high-risk moderation actions on the same channels, see moderation and safety tools. For sending structured layouts instead of plain text, see commands and interactions tools and the rich announcement recipe.
Next steps#
Back to all tool categories or the overview.