Discordbot | Composio Docs

Overview

SLUG: DISCORDBOT

Description

Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions

Authentication Details

OAuth2

client_id

stringRequired

client_secret

stringRequired

bearer_token

stringRequired

oauth_redirect_uri

stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add

scopes

stringDefaults to identify,email,bot,messages.read

Bearer Token

bearer_token

stringRequired

token

stringRequired

Connecting to Discordbot

Create an auth config

Use the dashboard to create an auth config for the Discordbot toolkit. This allows you to connect multiple Discordbot accounts to Composio for agents to use.

Select App

Navigate to the Discordbot toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1 from composio import Composio
2 
3 # Replace these with your actual values
4 discordbot_auth_config_id = "ac_YOUR_DISCORDBOT_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/application
6 
7 composio = Composio()
8 
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     connection_request = composio.connected_accounts.initiate(
12         user_id=user_id,
13         auth_config_id=auth_config_id,
14     )
15 
16     print(
17         f"Visit this URL to authenticate Discordbot: {connection_request.redirect_url}"
18     )
19 
20     # This will wait for the auth flow to be completed
21     connection_request.wait_for_connection(timeout=15)
22     return connection_request.id
23 
24 
25 connection_id = authenticate_toolkit(user_id, discordbot_auth_config_id)
26 
27 # You can also verify the connection status using:
28 connected_account = composio.connected_accounts.get(connection_id)
29 print(f"Connected account: {connected_account}")

Using Bearer Token

1 from composio import Composio
2 
3 # Auth config ID created above
4 discordbot_auth_config_id = "ac_YOUR_DISCORDBOT_CONFIG_ID" 
5 
6 # UUID from database/application
7 user_id = "0000-0000-0000"
8 
9 composio = Composio()
10 
11 
12 def authenticate_toolkit(user_id: str, auth_config_id: str):
13     # Replace this with a method to retrieve the Bearer Token from the user.
14     bearer_token = input("[!] Enter bearer token")
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "BEARER_TOKEN", "val": bearer_token}
19     )
20     print(f"Successfully connected Discordbot for user {user_id}")
21     print(f"Connection status: {connection_request.status}")
22     
23     return connection_request.id
24 
25 
26 connection_id = authenticate_toolkit(user_id, discordbot_auth_config_id)
27 
28 # You can verify the connection using:
29 connected_account = composio.connected_accounts.get(connection_id)
30 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Discordbot toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["DISCORDBOT"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

DISCORDBOT_ADD_GUILD_MEMBER_ROLE

Tool Name: Assign role to guild member

Description

Assigns a role to a guild member, provided the bot has 'manage roles' permission in the guild and the role to be assigned is hierarchically lower than the bot's highest role.

Action Parameters

guild_id

stringRequired

role_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_DM

Tool Name: Initiate user channel with recipient

Description

Creates a new direct message (dm) channel or retrieves an existing one, using `recipient id` for a 1-on-1 dm or `access tokens` for a group dm; this action only establishes or fetches the channel and does not send messages.

Action Parameters

access_tokens

array

nicks

object

recipient_id

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD

Tool Name: Create new guild object

Description

Creates a new discord guild (server) with the specified name, roles, and channels; icon must be a base64 encoded 128x128 image, and if `afk channel id` is set, `afk timeout` must also be set.

Action Parameters

afk_channel_id

null

afk_timeout

null

channels

array

default_message_notifications

null

description

string

explicit_content_filter

null

icon

string

name

stringRequired

preferred_locale

null

region

string

roles

array

system_channel_flags

integer

system_channel_id

null

verification_level

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_MEMBER_ROLE

Tool Name: Delete guild member role

Description

Removes a specified role from a member of a discord guild, provided the member currently possesses that role.

Action Parameters

guild_id

stringRequired

role_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_USER

Tool Name: Retrieve user by id

Description

Fetches public information for a discord user, requiring a valid and existing user id (snowflake).

Action Parameters

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_MEMBERS

Tool Name: Get guild members

Description

Retrieves members for a discord guild; requires a valid guild id for an existing guild.

Action Parameters

after

integer

guild_id

stringRequired

limit

integer

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_ADD_GROUP_DM_USER

Tool Name: Add recipient to group channel

Description

Adds a user to a discord group direct message (dm) channel.

Action Parameters

access_token

string

channel_id

stringRequired

nick

string

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_ADD_GUILD_MEMBER

Tool Name: Update guild member information

Description

Adds a user (who is not already a member) to a guild using their `access token` (which must have `guilds.join` scope), optionally setting nickname, roles, mute/deaf status, or flags.

Action Parameters

access_token

stringRequired

deaf

boolean

flags

integer

guild_id

stringRequired

mute

boolean

nick

string

roles

array

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_ADD_MY_MESSAGE_REACTION

Tool Name: Add reaction to message

Description

Adds an emoji reaction from the authenticated user/bot to a specific message in a discord channel; does not return information about existing reactions.

Action Parameters

channel_id

stringRequired

emoji_name

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_ADD_THREAD_MEMBER

Tool Name: Add or update thread member

Description

Adds a user to a specific, unarchived thread; the user must have access to the thread's parent channel, and for private threads, the bot must already be a member.

Action Parameters

channel_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_BAN_USER_FROM_GUILD

Tool Name: Modify guild ban settings

Description

Permanently bans a user from a discord guild, optionally deleting their recent messages (specify deletion period in seconds or days, not both).

Action Parameters

delete_message_days

integer

delete_message_seconds

integer

guild_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_BULK_BAN_USERS_FROM_GUILD

Tool Name: Bulk ban users in guild with message deletion option

Description

Bans up to 200 users from a discord guild, optionally deleting their recent messages; the bot must have 'ban members' permission in the guild, and this action is irreversible.

Action Parameters

delete_message_seconds

integer

guild_id

stringRequired

user_ids

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_BULK_DELETE_MESSAGES

Tool Name: Bulk delete messages in channel

Description

Atomically bulk deletes messages in a discord channel for moderation or maintenance; deletion may not be instantaneous and messages are unrecoverable.

Action Parameters

channel_id

stringRequired

messages

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_APPLICATION_COMMAND

Tool Name: Create application command objects

Description

Creates a new global discord application command, accessible across guilds and in dms (if `dm permission` is true), noting global commands can take up to an hour to propagate and have registration limits; for guild-specific commands, use a different action.

Action Parameters

application_id

stringRequired

default_member_permissions

integer

description

string

description_localizations

object

dm_permission

boolean

name

stringRequired

name_localizations

object

options

array

type

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_AUTO_MODERATION_RULE

Tool Name: Create guild auto moderation rule

Description

Creates a new auto moderation rule for a discord guild, requiring 'manage guild' permission; rule parameters are passed in the json request body (see request schema description for body content).

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_CHANNEL_INVITE

Tool Name: Create channel invite

Description

Creates a new invite for the specified discord channel, provided the bot has 'create instant invite' permission for that channel.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_APPLICATION_COMMAND

Tool Name: Create guild application command

Description

Creates a new guild-specific application command (slash, user, or message) in discord; command name must be unique per type within the guild (max 100 total commands), and client ui updates may take up to an hour.

Action Parameters

application_id

stringRequired

default_member_permissions

integer

description

string

description_localizations

object

dm_permission

boolean

guild_id

stringRequired

name

stringRequired

name_localizations

object

options

array

type

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_CHANNEL

Tool Name: Create guild channel

Description

Creates a new discord channel (text, voice, category, etc.) within a guild, with options for permissions, topic, and type-specific settings.

Action Parameters

available_tags

array

bitrate

integer

default_auto_archive_duration

integer

default_forum_layout

integer

default_reaction_emoji

string

default_sort_order

integer

default_thread_rate_limit_per_user

integer

guild_id

stringRequired

name

stringRequired

nsfw

boolean

parent_id

string

permission_overwrites

array

position

integer

rate_limit_per_user

integer

rtc_region

string

topic

string

type

integer

user_limit

integer

video_quality_mode

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_EMOJI

Tool Name: Create guild emoji

Description

Creates a new custom emoji in a specified discord guild, requiring `create expressions` permission and adherence to guild emoji limits.

Action Parameters

guild_id

stringRequired

image

stringRequired

name

stringRequired

roles

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_FROM_TEMPLATE

Tool Name: Post guild template by code

Description

Creates a new discord guild by applying channels, roles, and settings from a specified, valid, and accessible guild template code.

Action Parameters

code

stringRequired

icon

string

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_ROLE

Tool Name: Create role with guild id

Description

Creates a new role in a discord guild with customizable name, permissions, color, hoist, mentionability, and icon; `icon` (custom image hash) and `unicode emoji` (standard emoji) are mutually exclusive.

Action Parameters

color

integer

guild_id

stringRequired

hoist

boolean

icon

string

mentionable

boolean

name

string

permissions

integer

unicode_emoji

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_SCHEDULED_EVENT

Tool Name: Create guild scheduled event

Description

Creates a new scheduled event in a discord guild; a separate json request body (not defined in this action's request schema model) with event details (e.g., name, type, schedule) is required, and its specific fields depend on the event's `entity type`.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_STICKER

Tool Name: Create guild sticker

Description

Uploads a png, apng, or lottie json file (max 512kb) as a new custom sticker to the specified discord guild; requires 'manage expressions' permissions and sufficient server boost level for sticker slots.

Action Parameters

description

string

file

string

guild_id

stringRequired

name

string

tags

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_GUILD_TEMPLATE

Tool Name: Create guild template

Description

Creates a template of an existing discord guild's structure (settings, roles, channels) but not its content (e.g., messages, members).

Action Parameters

description

string

guild_id

stringRequired

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_INTERACTION_RESPONSE

Tool Name: Post interaction callback

Description

Sends a response to a discord interaction (e.g., slash command, component); ensure response type is context-appropriate and initial reply is within 3 seconds.

Action Parameters

interaction_id

stringRequired

interaction_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_MESSAGE

Tool Name: Post message to channel

Description

Sends a message to a specified discord channel (text, embeds, stickers, components, attachments); requires `send messages` permission and one of `content`, `embeds`, `sticker ids`, or `attachments`.

Action Parameters

allowed_mentions

null

attachments

array

channel_id

stringRequired

components

array

content

string

embeds

array

flags

integer

message_reference

null

nonce

integer

sticker_ids

array

tts

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_STAGE_INSTANCE

Tool Name: Create stage instance

Description

Creates a new stage instance in a specified stage channel for live audio events; requires `manage channels`, `mute members`, and `move members` permissions in the channel.

Action Parameters

channel_id

stringRequired

guild_scheduled_event_id

null

privacy_level

null

send_start_notification

boolean

topic

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_THREAD

Tool Name: Create new thread in channel

Description

Creates a new thread in a text or announcement discord channel; requires a 'name' and optionally other details (e.g., 'auto archive duration', an initial 'message') in the request body.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_THREAD_FROM_MESSAGE

Tool Name: Create thread in message channel

Description

Creates a new thread from a specific message in a discord channel, requiring `create public threads` permission (and `send messages` if in a forum/media channel).

Action Parameters

auto_archive_duration

null

channel_id

stringRequired

message_id

stringRequired

name

stringRequired

rate_limit_per_user

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CREATE_WEBHOOK

Tool Name: Create channel webhook

Description

Creates a webhook in a specified discord channel for external applications to post messages, provided the caller has 'manage webhooks' permission in that channel.

Action Parameters

avatar

string

channel_id

stringRequired

name

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_CROSSPOST_MESSAGE

Tool Name: Crosspost channel message

Description

Crossposts a message from an announcement channel to all following channels, provided the message has not been previously crossposted and is not a system message or a message sent by a webhook.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS

Tool Name: Delete reaction from message

Description

Deletes all reactions (not just the bot's) from a message in a channel; requires 'manage messages' permission.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI

Tool Name: Delete channel message reaction by emoji

Description

Removes all reactions for a specific emoji from a message in a discord channel; requires 'manage messages' permission and this operation is irreversible.

Action Parameters

channel_id

stringRequired

emoji_name

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_APPLICATION_COMMAND

Tool Name: Delete application command

Description

Permanently deletes a specific application command; this action is irreversible.

Action Parameters

application_id

stringRequired

command_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_AUTO_MODERATION_RULE

Tool Name: Delete guild auto moderation rule

Description

Deletes a specific auto-moderation rule from a discord guild.

Action Parameters

guild_id

stringRequired

rule_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_CHANNEL

Tool Name: Delete channel by id

Description

Permanently deletes a discord channel by its id; this action is irreversible and the channel must exist and be deletable.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_CHANNEL_PERMISSION_OVERWRITE

Tool Name: Delete channel permission override

Description

Deletes a specific user's or role's permission overwrite in a discord channel, reverting their permissions to default; this action is irreversible.

Action Parameters

channel_id

stringRequired

overwrite_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GROUP_DM_USER

Tool Name: Delete channel recipient

Description

Permanently removes a user from an accessible discord group dm channel, revoking their access.

Action Parameters

channel_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD

Tool Name: Delete guild by id

Description

Permanently deletes a specified discord guild (server); the authenticated user must be the owner of the guild.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_APPLICATION_COMMAND

Tool Name: Delete guild command

Description

Permanently deletes a specific application command (e.g., slash, user, or message) for an application from a discord guild, used to remove outdated or unnecessary commands.

Action Parameters

application_id

stringRequired

command_id

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_EMOJI

Tool Name: Delete guild emoji by id

Description

Permanently deletes a specified custom emoji from a guild, requiring 'manage expressions' permissions; cannot delete default emojis and is irreversible.

Action Parameters

emoji_id

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_INTEGRATION

Tool Name: Delete guild integration

Description

Permanently deletes a specific, unwanted or problematic integration from a discord guild; requires 'manage server' or 'administrator' permissions.

Action Parameters

guild_id

stringRequired

integration_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_MEMBER

Tool Name: Delete guild member by id

Description

Removes (kicks) a member from a discord guild; the user must be an existing member of the specified guild, and this action is permanent.

Action Parameters

guild_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_ROLE

Tool Name: Delete role from guild

Description

Permanently deletes a specified role from a discord guild, revoking it from all members; requires 'manage roles' permission and the target role must be lower in hierarchy than the bot's highest role.

Action Parameters

guild_id

stringRequired

role_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_SCHEDULED_EVENT

Tool Name: Delete guild scheduled event

Description

Permanently deletes a specific scheduled event from a discord guild; this action is irreversible.

Action Parameters

guild_id

stringRequired

guild_scheduled_event_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_STICKER

Tool Name: Delete guild sticker

Description

Permanently deletes a custom sticker from a discord guild; the specified guild and sticker must exist, and this action is irreversible.

Action Parameters

guild_id

stringRequired

sticker_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_GUILD_TEMPLATE

Tool Name: Delete guild template by code

Description

Deletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.

Action Parameters

code

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_MESSAGE

Tool Name: Delete channel message

Description

Permanently and irreversibly deletes a message from a specified discord channel.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_MY_MESSAGE_REACTION

Tool Name: Delete user reaction on message

Description

Removes the authenticated user's own emoji reaction, which they must have previously added, from a specific message in a discord channel; this action is irreversible and cannot remove others' reactions.

Action Parameters

channel_id

stringRequired

emoji_name

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_ORIGINAL_WEBHOOK_MESSAGE

Tool Name: Delete original webhook message

Description

Permanently deletes an existing original message posted by a webhook (using its id and token), optionally within a specific thread.

Action Parameters

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_STAGE_INSTANCE

Tool Name: Delete stage instance by channel id

Description

Deletes the stage instance for the given `channel id`, permanently ending its live audio event.

Action Parameters

channel_id

stringRequired

Action Response

data

object

error

string

successful

booleanRequired

DISCORDBOT_DELETE_THREAD_MEMBER

Tool Name: Delete channel thread member

Description

Removes a user from a specified, unarchived thread in a discord channel.

Action Parameters

channel_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_USER_MESSAGE_REACTION

Tool Name: Delete user reaction from message

Description

Removes a specific user's emoji reaction from a message; requires 'manage messages' permission if deleting reactions from other users.

Action Parameters

channel_id

stringRequired

emoji_name

stringRequired

message_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_WEBHOOK

Tool Name: Delete webhook by id

Description

Permanently deletes a specified, existing discord webhook by its unique id; this action is irreversible.

Action Parameters

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_WEBHOOK_BY_TOKEN

Tool Name: Delete webhook using id and token

Description

Permanently deletes a discord webhook specified by its id and token; this action is irreversible.

Action Parameters

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_DELETE_WEBHOOK_MESSAGE

Tool Name: Delete webhook message

Description

Deletes a message previously sent by the specified webhook, optionally within a specific thread.

Action Parameters

message_id

stringRequired

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_EXECUTE_GITHUB_COMPATIBLE_WEBHOOK

Tool Name: Github action webhooks processing

Description

Forwards github event notifications to a discord channel via a webhook configured for github-formatted payloads (url ending in `/github`).

Action Parameters

action

string

answer

null

check_run

null

check_suite

null

comment

null

commits

array

compare

string

discussion

null

forced

boolean

forkee

null

head_commit

null

issue

null

member

null

pull_request

null

ref

string

ref_type

string

release

null

repository

null

review

null

sender__avatar__url

string

sender__html__url

string

sender__id

integer

sender__login

string

thread_id

string

wait

boolean

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_EXECUTE_SLACK_COMPATIBLE_WEBHOOK

Tool Name: Post to slack webhook

Description

Sends richly formatted messages to discord via its slack-compatible webhook endpoint; requires at least one of `text` or `attachments` and adherence to content limits.

Action Parameters

attachments

array

icon_url

string

text

string

thread_id

string

username

string

wait

boolean

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

stringRequired

error

string

successful

booleanRequired

DISCORDBOT_EXECUTE_WEBHOOK

Tool Name: Post webhook with embeds and components

Description

Executes a discord webhook to send messages, embeds, or interactive components to a specific discord channel or thread.

Action Parameters

thread_id

string

wait

boolean

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_FOLLOW_CHANNEL

Tool Name: Add follower to channel via webhook

Description

Follows a specified announcement channel (`channel id`), relaying its messages to `webhook channel id` in the current server; requires 'manage webhooks' permission in the current server and that it has community features enabled.

Action Parameters

channel_id

stringRequired

webhook_channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_ACTIVE_GUILD_THREADS

Tool Name: List active threads in guild

Description

Retrieves all currently active and visible threads within a specified discord guild, excluding archived or hidden threads.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_APPLICATION

Tool Name: Retrieve application details

Description

Retrieves the full details of a discord application using its unique `application id`.

Action Parameters

application_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_APPLICATION_COMMAND

Tool Name: Fetch application command by id

Description

Fetches the details of a specific, existing application command, identified by its application snowflake id and command snowflake id.

Action Parameters

application_id

stringRequired

command_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_APPLICATION_ROLE_CONNECTIONS_METADATA

Tool Name: Retrieve application role metadata

Description

Retrieves all role connection metadata records for a given discord application id; an empty list is returned if none are configured.

Action Parameters

application_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_APPLICATION_USER_ROLE_CONNECTION

Tool Name: Get user role connection

Description

Fetches the role connection object for the current user for a specified discord application.

Action Parameters

application_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_AUTO_MODERATION_RULE

Tool Name: Retrieve auto moderation rule

Description

Retrieves the complete configuration details of a specific auto-moderation rule within a discord guild for inspection or verification.

Action Parameters

guild_id

stringRequired

rule_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_BOT_GATEWAY

Tool Name: Retrieve bot gateway

Description

Retrieves the wss url, recommended shard count, and session start limits, which are prerequisite for a bot to connect to the discord gateway and receive events.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_CHANNEL

Tool Name: Retrieve channel details

Description

Retrieves detailed metadata for a specific discord channel using its `channel id`, which must be a valid and accessible channel id; note that this action returns only channel metadata, not message content or member lists.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GATEWAY

Tool Name: Get gateway details

Description

Retrieves the websocket url to connect to discord's gateway for receiving real-time events.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD

Tool Name: Retrieve guild details

Description

Retrieves detailed information for a specified discord guild (server) by its `guild id`, optionally including approximate member and presence counts if `with counts` is true.

Action Parameters

guild_id

stringRequired

with_counts

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILDS_ONBOARDING

Tool Name: Get guild onboarding by id

Description

Retrieves the onboarding settings for a specified discord guild, including prompts, options, default channels, and enabled status, to examine its new member guidance process when the guild id is known and accessible.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_APPLICATION_COMMAND

Tool Name: Fetch guild application command by id

Description

Fetches detailed information for a specific application command within a discord guild, identified by `application id`, `guild id`, and `command id`.

Action Parameters

application_id

stringRequired

command_id

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_APPLICATION_COMMAND_PERMISSIONS

Tool Name: Retrieve guild command permissions

Description

Fetches the permissions for a specific application command within a guild, used to inspect its current access settings.

Action Parameters

application_id

stringRequired

command_id

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_BAN

Tool Name: Retrieve guild user ban details

Description

Fetches the ban details for a specific user in a discord guild, if that user is currently banned.

Action Parameters

guild_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_EMOJI

Tool Name: Fetch emoji by guild and id

Description

Retrieves details for a specific custom emoji within a specified discord guild, requiring valid and accessible guild and emoji ids.

Action Parameters

emoji_id

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_MEMBER

Tool Name: Retrieve guild member by user id

Description

Retrieves detailed information for a specific member of a discord guild, provided the bot belongs to the guild and has necessary permissions (e.g., guild members intent).

Action Parameters

guild_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_NEW_MEMBER_WELCOME

Tool Name: Retrieve guild new member welcome

Description

Retrieves the configured new member welcome screen for a discord guild, detailing the welcome message, suggested member actions, and resource channels.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_PREVIEW

Tool Name: Preview guild by id

Description

Fetches a public preview of a discord guild by its id, if the guild has the preview feature enabled.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_SCHEDULED_EVENT

Tool Name: Get guild scheduled event by id

Description

Retrieves a specific scheduled event from a discord guild by its id, optionally including the count of subscribed users.

Action Parameters

guild_id

stringRequired

guild_scheduled_event_id

stringRequired

with_user_count

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_STICKER

Tool Name: Retrieve sticker from guild

Description

Retrieves a specific sticker from a discord guild using the guild and sticker ids; requires the sticker to exist in the guild.

Action Parameters

guild_id

stringRequired

sticker_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_TEMPLATE

Tool Name: Retrieve guild template with code

Description

Retrieves the complete structure and details of a discord guild template using its unique code; the code must be valid and refer to an existing, accessible template.

Action Parameters

code

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_VANITY_URL

Tool Name: Retrieve guild vanity url

Description

Fetches the vanity url, including the invite `code` and its `uses` count, for a given discord `guild id`, which must correspond to an existing guild.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_WEBHOOKS

Tool Name: Retrieve guild webhooks

Description

Retrieves all webhook objects for a specified discord guild; requires 'manage webhooks' permission for the authenticated entity.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_WELCOME_SCREEN

Tool Name: Retrieve guild welcome screen

Description

Retrieves the configured welcome screen for a specific discord guild that has the 'community' feature enabled.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_WIDGET

Tool Name: Retrieve guild widget json

Description

Retrieves the public json widget data for a discord guild, if the widget is enabled for that guild.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_GUILD_WIDGET_SETTINGS

Tool Name: Retrieve guild widget information

Description

Retrieves the widget settings for a specified discord guild, indicating if the widget is enabled and its configured channel id; requires a valid `guild id`.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_MESSAGE

Tool Name: Retrieve message from channel

Description

Retrieves a specific message from a discord channel, identified by `channel id` and `message id`, if the channel and message exist and are accessible.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_MY_APPLICATION

Tool Name: Get your applications

Description

Retrieves detailed information about the current authenticated discord application.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_MY_OAUTH2_APPLICATION

Tool Name: Get oauth2 applications for current user

Description

Retrieves detailed information about the oauth2 application associated with the current authentication; cannot query other applications.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_ORIGINAL_WEBHOOK_MESSAGE

Tool Name: Retrieve original webhook message

Description

Fetches the original, unedited message posted by a specific discord webhook, requiring a message to have been previously sent by this webhook and to exist in the specified thread if `thread id` is provided.

Action Parameters

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_PUBLIC_KEYS

Tool Name: Get oauth2 keys

Description

Retrieves discord's oauth2 public keys (jwk format) for verifying access tokens; keys may rotate, so refresh caches periodically.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_STAGE_INSTANCE

Tool Name: Retrieve stage instance by channel id

Description

Gets the active stage instance for a given stage channel id.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_STICKER

Tool Name: Retrieve sticker by id

Description

Retrieves a specific discord sticker by its unique id.

Action Parameters

sticker_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_THREAD_MEMBER

Tool Name: Retrieve thread member by id

Description

Retrieves a member from a specified thread using their user id, optionally including the full guild member object.

Action Parameters

channel_id

stringRequired

user_id

stringRequired

with_member

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_WEBHOOK

Tool Name: Retrieve webhook by id

Description

Retrieves detailed information for an existing discord webhook, identified by its unique id, to verify settings or manage the webhook.

Action Parameters

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_WEBHOOK_BY_TOKEN

Tool Name: Retrieve webhook information

Description

Fetches a discord webhook's configuration details (e.g., name, avatar, channel id) using its id and token; this excludes message history or usage statistics.

Action Parameters

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_GET_WEBHOOK_MESSAGE

Tool Name: Retrieve webhook message by id

Description

Retrieves a specific message previously sent by a discord webhook using its `message id`, requiring `thread id` if the message is part of a thread.

Action Parameters

message_id

stringRequired

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_INVITE_RESOLVE

Tool Name: Retrieve invite by code

Description

Resolves a discord invite code to get its details, optionally including member counts or data for a specific guild scheduled event; visibility of some details may depend on bot permissions.

Action Parameters

code

stringRequired

guild_scheduled_event_id

string

with_counts

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_INVITE_REVOKE

Tool Name: Delete invite via code

Description

Revokes a discord server invite using its unique code, permanently preventing new joins via this link (does not affect existing members); requires 'manage server' or 'manage invites' permissions on the server.

Action Parameters

code

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_JOIN_THREAD

Tool Name: Update thread membership

Description

Joins the authenticated user to a thread specified by `channel id`; use this when the user is not already a member, for archived threads, or for threads requiring explicit joining, provided the thread is joinable, not locked or full, and the user has permissions.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LEAVE_GUILD

Tool Name: Delete user guild

Description

Enables the authenticated user to leave a specified discord guild of which they are a member but not the owner; this action is irreversible.

Action Parameters

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LEAVE_THREAD

Tool Name: Remove current user from thread

Description

Removes the currently authenticated user from a specified, existing, and accessible discord thread of which they are currently a member.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_APPLICATION_COMMANDS

Tool Name: List commands for application

Description

Fetches all global application commands for the specified discord application id; does not fetch guild-specific commands.

Action Parameters

application_id

stringRequired

with_localizations

boolean

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_AUTO_MODERATION_RULES

Tool Name: Retrieve guild auto moderation rules

Description

Fetches all auto moderation rules for a specified discord guild to review or audit its configuration; requires `view audit log` permissions and the action does not modify rules.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_CHANNEL_INVITES

Tool Name: List Channel Invites

Description

Fetches all active invites for a given discord channel id (read-only), requiring channel invite view permissions; response object structures may vary.

Action Parameters

channel_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_CHANNEL_WEBHOOKS

Tool Name: Retrieve channel webhooks

Description

Fetches detailed information for all webhooks in a given valid discord channel, useful for review or auditing purposes.

Action Parameters

channel_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_APPLICATION_COMMANDS

Tool Name: Fetch guild commands via application id

Description

Fetches all application command definitions (slash, user, and message types) for a specific application within a given discord guild, optionally including localizations; does not return permissions or usage statistics.

Action Parameters

application_id

stringRequired

guild_id

stringRequired

with_localizations

boolean

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_APPLICATION_COMMAND_PERMISSIONS

Tool Name: Get application guild command permissions

Description

Call this action to retrieve all explicitly set guild-level permission settings for all commands of a specific application within a given guild, typically for auditing or troubleshooting command access.

Action Parameters

application_id

stringRequired

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_AUDIT_LOG_ENTRIES

Tool Name: Get guild audit logs by guild id

Description

Retrieves audit log entries (e.g., message deletions, member kicks/bans, role changes) for a specified discord guild, requiring 'view audit log' permission.

Action Parameters

action_type

integer

after

string

before

string

guild_id

stringRequired

limit

integer

target_id

string

user_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_BANS

Tool Name: List guild bans

Description

Fetches a list of users banned from a specified discord guild; `before`/`after` parameters require user ids from previous results for correct pagination.

Action Parameters

after

string

before

string

guild_id

stringRequired

limit

integer

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_CHANNELS

Tool Name: Retrieve guild channels

Description

Fetches all channels (e.g., text, voice, category, threads) and their structural information for a specified discord guild id; does not include message content.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_EMOJIS

Tool Name: Retrieve guild emojis

Description

Fetches all custom emoji objects for a specified discord guild if the bot has access; returns only custom guild emojis, not standard unicode or nitro emojis.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_INTEGRATIONS

Tool Name: List guild integrations

Description

Lists all integration objects for a specified discord guild.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_INVITES

Tool Name: Retrieve guild invites by id

Description

Retrieves all currently active invite codes for a specified discord guild, typically for administration, analytics, or managing guild invitations.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_ROLES

Tool Name: List guild roles

Description

Fetches all roles in a discord guild, providing details for each role but not user assignments; `guild id` must be valid.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_SCHEDULED_EVENTS

Tool Name: Retrieve guild scheduled events

Description

Retrieves a list of scheduled events for a specified discord guild, optionally including subscribed user counts, provided the authenticated user/bot has access to the guild.

Action Parameters

guild_id

stringRequired

with_user_count

boolean

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_SCHEDULED_EVENT_USERS

Tool Name: Retrieve users for scheduled event

Description

Fetches users who have expressed interest in a specific scheduled event, requiring valid guild and event ids.

Action Parameters

after

string

before

string

guild_id

stringRequired

guild_scheduled_event_id

stringRequired

limit

integer

with_member

boolean

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_STICKERS

Tool Name: Retrieve guild stickers

Description

Retrieves all custom sticker objects for a discord guild; does not include standard/nitro stickers.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_TEMPLATES

Tool Name: Get guild templates by guild id

Description

Retrieves all guild templates for an existing discord guild, specified by its id.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_GUILD_VOICE_REGIONS

Tool Name: List guild regions

Description

Fetches a list of available voice regions for a specified discord guild.

Action Parameters

guild_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_MESSAGES

Tool Name: Fetch messages from channel

Description

Retrieves historical messages from a specified, accessible discord channel, typically newest first; for real-time messages, use discord's websocket gateway api.

Action Parameters

after

string

around

string

before

string

channel_id

stringRequired

limit

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI

Tool Name: Get channel message reaction by emoji

Description

Fetches a list of users who reacted to a specific message with a given emoji in a discord channel; retrieves users for one emoji at a time.

Action Parameters

after

string

channel_id

stringRequired

emoji_name

stringRequired

limit

integer

message_id

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_MY_PRIVATE_ARCHIVED_THREADS

Tool Name: Get private archived threads for user

Description

Retrieves private archived threads from a specified channel that the current user is a member of.

Action Parameters

before

string

channel_id

stringRequired

limit

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_PINNED_MESSAGES

Tool Name: Retrieve pinned messages in channel

Description

Retrieves all currently pinned messages from a discord channel using its valid, existing id; typically limited to 50 messages, and no history of past pins is returned.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_PRIVATE_ARCHIVED_THREADS

Tool Name: Get archived private threads by channel id

Description

Lists a channel's private archived threads, sorted by most recent archival, requiring view access to them.

Action Parameters

before

string

channel_id

stringRequired

limit

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_PUBLIC_ARCHIVED_THREADS

Tool Name: Get archived public threads by channel id

Description

Lists public archived threads in an accessible discord channel, returning an empty list if none exist; does not list private or active threads.

Action Parameters

before

string

channel_id

stringRequired

limit

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_STICKER_PACKS

Tool Name: List sticker packs

Description

Fetches sticker packs available to nitro subscribers on discord, excluding custom or guild-specific ones.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_THREAD_MEMBERS

Tool Name: List thread members in channel

Description

Retrieves members of a specified discord thread, with an option to include full guild member objects for each.

Action Parameters

after

string

channel_id

stringRequired

limit

integer

with_member

boolean

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_LIST_VOICE_REGIONS

Tool Name: Fetch voice regions list

Description

Lists all available discord voice regions with their id, name, operational status (custom, deprecated, optimal), noting that availability may vary by server.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_PIN_MESSAGE

Tool Name: Pin message in channel

Description

Pins a message in a discord channel for increased visibility, if the channel's pin limit (typically 50) is not exceeded.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_PREVIEW_PRUNE_GUILD

Tool Name: Retrieve guild prune info

Description

Previews the number of members that would be pruned from a discord guild based on inactivity days and optional roles; this action only returns a count and does not remove members.

Action Parameters

days

integer

guild_id

stringRequired

include_roles

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_PRUNE_GUILD

Tool Name: Prune guild members by roles

Description

Removes inactive members from a discord guild, requiring 'kick members' permission; use `compute prune count=true` to preview results before actual removal.

Action Parameters

compute_prune_count

boolean

days

integer

guild_id

stringRequired

include_roles

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_PUT_GUILDS_ONBOARDING

Tool Name: Update guild onboarding configuration

Description

Configures or updates a discord guild's new member onboarding flow, including defining prompts with options, assigning roles/channels, setting default channels, and managing the flow's active status.

Action Parameters

default_channel_ids

array

enabled

boolean

guild_id

stringRequired

mode

null

prompts

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_SEARCH_GUILD_MEMBERS

Tool Name: Search guild members by id

Description

Searches for members in a specific discord guild, allowing filtering by a query string.

Action Parameters

guild_id

stringRequired

limit

integerRequired

query

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

DISCORDBOT_SET_CHANNEL_PERMISSION_OVERWRITE

Tool Name: Modify channel permissions

Description

Updates or creates a permission overwrite for a role (type `0`) or member (type `1`) specified by `overwrite id` within an existing discord channel (`channel id`), using `allow` and `deny` bitwise values to precisely control permissions.

Action Parameters

allow

integer

channel_id

stringRequired

deny

integer

overwrite_id

stringRequired

type

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_SYNC_GUILD_TEMPLATE

Tool Name: Update guild template by code

Description

Synchronizes a guild template (by `code`) with its source guild (`guild id`), updating it to match the source's current configuration; this does not affect guilds already created from this template.

Action Parameters

code

stringRequired

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_TRIGGER_TYPING_INDICATOR

Tool Name: Trigger typing indicator

Description

Shows the bot is 'typing' in a discord channel, typically before sending a message; indicator stops after 10 seconds or upon message send, so use when actively preparing a response.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UNBAN_USER_FROM_GUILD

Tool Name: Delete guild user ban

Description

Revokes a ban for a user from a discord guild, allowing them to rejoin if they choose.

Action Parameters

guild_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UNPIN_MESSAGE

Tool Name: Delete channel message pin

Description

Unpins a message that is currently pinned in a specified discord channel; the message itself is not deleted.

Action Parameters

channel_id

stringRequired

message_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_APPLICATION

Tool Name: Modify application by id

Description

Updates a discord application's settings using its `application id`; `max participants` requires the `application embedded activities` flag, and `team id`, `type`, or `install params` must be `null` if specified.

Action Parameters

application_id

stringRequired

cover_image

string

custom_install_url

string

description__default

string

description__localizations

object

flags

integer

icon

string

install_params

null

interactions_endpoint_url

string

max_participants

integer

role_connections_verification_url

string

tags

array

team_id

null

type

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_APPLICATION_COMMAND

Tool Name: Patch command for application

Description

Updates specified properties of a discord application command (e.g., name, description); omitted properties remain unchanged, and the `options` field, if provided, overwrites all existing options.

Action Parameters

application_id

stringRequired

command_id

stringRequired

default_member_permissions

integer

description

string

description_localizations

object

dm_permission

boolean

name

string

name_localizations

object

options

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_APPLICATION_USER_ROLE_CONNECTION

Tool Name: Update user application role connection

Description

Updates the authorized user's role connection for a specific application, which must have a linked role connection configured.

Action Parameters

application_id

stringRequired

metadata

object

platform_name

string

platform_username

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_AUTO_MODERATION_RULE

Tool Name: Modify guild auto moderation rule

Description

Updates an existing auto-moderation rule, identified by `guild id` and `rule id` in the path, with new values for rule properties (e.g., `name`, `event type`) provided in the request body.

Action Parameters

guild_id

stringRequired

rule_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_CHANNEL

Tool Name: Patch channel properties by id

Description

Partially updates an existing discord channel, using `channel id` for identification and properties in the request body for changes, ensuring these properties are applicable to the channel's type.

Action Parameters

channel_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD

Tool Name: Update guild settings

Description

Updates settings for a discord guild, such as its name, region, or icon; transferring ownership requires being the current owner, and managing features or certain visual elements (e.g., banners, splashes) may require specific permissions or guild statuses like 'community' or 'vip'.

Action Parameters

afk_channel_id

null

afk_timeout

null

banner

string

default_message_notifications

null

description

string

discovery_splash

string

explicit_content_filter

null

features

array

guild_id

stringRequired

home_header

string

icon

string

name

string

owner_id

string

preferred_locale

null

premium_progress_bar_enabled

boolean

public_updates_channel_id

null

region

string

rules_channel_id

null

safety_alerts_channel_id

null

splash

string

system_channel_flags

integer

system_channel_id

null

verification_level

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_APPLICATION_COMMAND

Tool Name: Update application guild command

Description

Updates a specific discord application command's properties (like name, description, options, or permissions) within a given guild; `application id`, `guild id`, and `command id` must refer to valid entities.

Action Parameters

application_id

stringRequired

command_id

stringRequired

default_member_permissions

integer

description

string

description_localizations

object

dm_permission

boolean

guild_id

stringRequired

name

string

name_localizations

object

options

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_EMOJI

Tool Name: Update guild emoji roles

Description

Updates a custom emoji's name and/or role restrictions in a discord guild; cannot create or delete emojis, and role updates for managed emojis may be restricted by their integration.

Action Parameters

emoji_id

stringRequired

guild_id

stringRequired

name

string

roles

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_MEMBER

Tool Name: Modify guild member details

Description

Updates a guild member's attributes (e.g., nickname, roles, voice state); if moving via `channel id`, it must be a valid voice channel in the guild.

Action Parameters

channel_id

null

communication_disabled_until

string

deaf

boolean

flags

integer

guild_id

stringRequired

mute

boolean

nick

string

roles

array

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_ROLE

Tool Name: Modify guild role

Description

Updates a discord guild role's attributes (name, permissions, color, etc.); requires `manage roles` permission, and the `role icons` guild feature if using `unicode emoji`; unspecified attributes remain unchanged.

Action Parameters

color

integer

guild_id

stringRequired

hoist

boolean

icon

string

mentionable

boolean

name

string

permissions

integer

role_id

stringRequired

unicode_emoji

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_SCHEDULED_EVENT

Tool Name: Update guild scheduled event

Description

Updates attributes such as name, description, schedule, status, or location for an existing discord guild event; only fields in the request body are changed.

Action Parameters

guild_id

stringRequired

guild_scheduled_event_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_STICKER

Tool Name: Update guild sticker info

Description

Modifies a guild sticker's name, description, or tags, requiring 'manage emojis and stickers' permission.

Action Parameters

description

string

guild_id

stringRequired

name

string

sticker_id

stringRequired

tags

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_TEMPLATE

Tool Name: Patch guild template information

Description

Updates a discord guild template's `name` and/or `description` given its `guild id` and template `code`; omitted fields retain current values, and an empty string for `description` clears it.

Action Parameters

code

stringRequired

description

string

guild_id

stringRequired

name

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_WELCOME_SCREEN

Tool Name: Update guild welcome screen

Description

Updates a guild's welcome screen, including its description, enabled status, and up to 5 welcome channels; when specifying channel emojis, use `emoji name` as `emoji id` must be `null` if sent.

Action Parameters

description

string

enabled

boolean

guild_id

stringRequired

welcome_channels

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_GUILD_WIDGET_SETTINGS

Tool Name: Patch guild widget endpoint

Description

Updates an existing discord guild's widget settings, such as its enabled state or clearing its invite channel.

Action Parameters

channel_id

null

enabled

boolean

guild_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_MESSAGE

Tool Name: Update channel message

Description

Updates a message previously sent by the bot in a discord channel, by modifying its content, embeds, components, flags, or attachment metadata (new attachments cannot be uploaded); only provide fields to change, using null or an empty list to clear existing values.

Action Parameters

allowed_mentions

null

attachments

array

channel_id

stringRequired

components

array

content

string

embeds

array

flags

integer

message_id

stringRequired

sticker_ids

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_MY_APPLICATION

Tool Name: Update application description

Description

Modifies settings for the current authenticated discord application (e.g., description, icon, interaction urls); setting `team id` to `null` (none) transfers team ownership, while `null` (none) for `type` or `install params` clears/resets them.

Action Parameters

cover_image

string

custom_install_url

string

description__default

string

description__localizations

object

flags

integer

icon

string

install_params

null

interactions_endpoint_url

string

max_participants

integer

role_connections_verification_url

string

tags

array

team_id

null

type

null

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_MY_GUILD_MEMBER

Tool Name: Modify guild member nickname

Description

Modifies the nickname of the currently authenticated user within a specified discord guild.

Action Parameters

guild_id

stringRequired

nick

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_MY_USER

Tool Name: Update current user profile

Description

Updates the current authenticated user's discord username and/or avatar.

Action Parameters

avatar

string

username

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_ORIGINAL_WEBHOOK_MESSAGE

Tool Name: Patch webhook original message

Description

Updates the original editable message previously sent by a webhook, allowing partial modification of its content (max 2000 chars), embeds (max 10), attachments (kept by `id`, metadata updatable), components, allowed mentions, and flags.

Action Parameters

allowed_mentions

null

attachments

array

components

array

content

string

embeds

array

flags

integer

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_SELF_VOICE_STATE

Tool Name: Modify guild voice state for me

Description

Updates the current user's voice state in a guild (e.g., mute, request to speak), and can explicitly disconnect the user from voice; this action does not support joining or switching voice channels.

Action Parameters

channel_id

null

guild_id

stringRequired

request_to_speak_timestamp

string

suppress

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_VOICE_STATE

Tool Name: Patch guild voice state

Description

Updates a user's voice state in a discord guild, such as toggling server mute or disconnecting from a voice channel; requires `mute members` permission to change mute status or `move members` to disconnect.

Action Parameters

channel_id

null

guild_id

stringRequired

suppress

boolean

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_WEBHOOK

Tool Name: Update webhook details patch

Description

Updates properties (e.g., name, avatar, channel id) of an existing discord webhook; the webhook and any new channel (if specified) must exist, with the new channel being in the same server.

Action Parameters

avatar

string

channel_id

null

name

string

webhook_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_WEBHOOK_BY_TOKEN

Tool Name: Update webhook name and avatar

Description

Updates the default name and/or avatar for an existing discord webhook, using its id and token.

Action Parameters

avatar

string

name

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

DISCORDBOT_UPDATE_WEBHOOK_MESSAGE

Tool Name: Update discord message with webhook

Description

Updates a message previously sent by the *same* webhook, allowing partial modification of content, embeds, attachments, or components; will not edit user/bot messages.

Action Parameters

allowed_mentions

null

attachments

array

components

array

content

string

embeds

array

flags

integer

message_id

stringRequired

thread_id

string

webhook_id

stringRequired

webhook_token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired