discord

name

discord

description

Discord is a voice, video, and text communication platform that brings people together in private or community-based “servers,” enabling rich multimedia conversations, persistent chat rooms, and real-time interaction inside flexible, topic-focused groups. Read and write Discord data through One: applicationcommands, webhooks, channels, guildmembers, threads, webhookmessages and more, 229 actions with real parameter documentation. Use whenever the user asks to look something up in Discord, create or update a record there, or build code against the Discord API.

Discord through One

Discord is a voice, video, and text communication platform that brings people together in private or community-based “servers,” enabling rich multimedia conversations, persistent chat rooms, and real-time interaction inside flexible, topic-focused groups.

One exposes Discord through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform discord if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Discord is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Discord account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

ApplicationCommands

Action	Method	Path	Action id
Get a Guild Application Command	GET	/applications/{{applicationId}}/guilds/{{guildId}}/commands/{{commandId}}	conn_mod_def::GJ2WDkhWbpc::jUBSwoqWQV2vCF1gXdQLgQ
Get an Application Command	GET	/applications/{{applicationId}}/commands/{{commandId}}	conn_mod_def::GJ2WB83ehVM::SXDaDw0CRKqf3cHC6azm6A
List a Guild's Application Commands	GET	/applications/{{applicationId}}/guilds/{{guildId}}/commands	conn_mod_def::GJ2WK7VOklc::AOt1X6yfQu2lHiE_o1b9bA
List an Application's Commands	GET	/applications/{{applicationId}}/commands	conn_mod_def::GJ2WKGqx1BY::Yv1d6uXeTdeY9NnYWmDNkg
Bulk Set a Guild’s Application Commands	PUT	/applications/{{applicationId}}/guilds/{{guildId}}/commands	conn_mod_def::GJ2V3zmJyCk::D3kJj8E5QRWQbBfl6Q09eQ
Bulk Set an Application’s Commands	PUT	/applications/{{applicationId}}/commands	conn_mod_def::GJ2V3qRGHDw::AshN8fXQRJKDn1MVMe-xIw
Create a Guild Application Command	POST	/applications/{{applicationId}}/guilds/{{guildId}}/commands	conn_mod_def::GJ2V5P8Ig_I::TIyfYGDGRmqFRf0IvRGIgw
Create an Application Command	POST	/applications/{{applicationId}}/commands	conn_mod_def::GJ2V4cA4Y5o::wOEGwJcqQlenHb4tZjybSw
Delete an Application Command	DELETE	/applications/{{applicationId}}/commands/{{commandId}}	conn_mod_def::GJ2V8Y6Na2E::xT3OqJ3TQ2GJHuBoneK0yw
Update an Application Command	PATCH	/applications/{{applicationId}}/commands/{{commandId}}	conn_mod_def::GJ2WQ21L-eo::acm13q6nRky-FiII5xAhDQ

Webhooks

Action	Method	Path	Action id
Get a Webhook	GET	/webhooks/{{webhookId}}	conn_mod_def::GJ2WItKw6UU::LzKEUAkzR1GdqX-uR72DiA
Get a Webhook by Token	GET	/webhooks/{{webhookId}}/{{webhookToken}}	conn_mod_def::GJ2WI1f5u7s::CBthGQDRSKO-kwSAmXc8IQ
List a Channel’s Webhooks	GET	/channels/{{channelId}}/webhooks	conn_mod_def::GJ2WKoSBMgY::iTOk6FixTES1vd4WDAGY-g
List a Guild’s Webhooks	GET	/guilds/{{guildId}}/webhooks	conn_mod_def::GJ2WFLFh5O4::psuVCy70TSukSRW-2EDc-g
Delete a Webhook	DELETE	/webhooks/{{webhookId}}	conn_mod_def::GJ2V_6uBxOg::JF-yDhzlT8GsEkE-bOTJdw
Delete a Webhook by Token	DELETE	/webhooks/{{webhookId}}/{{webhookToken}}	conn_mod_def::GJ2WAC6i4AE::xHGclb-vRQCfmUMurB58cA
Execute a Slack-Compatible Webhook (Discord)	POST	/webhooks/{{webhookId}}/{{webhookToken}}/slack	conn_mod_def::GJ2WBIrQhr4::VRDVAEBFRz-_qUp4VLD8mQ
Execute a Webhook (Send a Webhook Message)	POST	/webhooks/{{webhookId}}/{{webhookToken}}	conn_mod_def::GJ2WBST2RPw::WmE91Pe7StWekkNMyNgQJA
Update a Webhook	PATCH	/webhooks/{{webhookId}}	conn_mod_def::GJ2WVEft77s::EuTdZttzS_qg3EGfPgOAzg
Update a Webhook by Token	PATCH	/webhooks/{{webhookId}}/{{webhookToken}}	conn_mod_def::GJ2WVLsk50Y::YDmILVuDS-aMzR3d7BZZwQ

Channels

Action	Method	Path	Action id
Get a Channel	GET	/channels/{{channelId}}	conn_mod_def::GJ2WCxcGK8w::1gzyr0RYRlixXWIhd8DK_A
List a Guild’s Channels	GET	/guilds/{{guildId}}/channels	conn_mod_def::GJ2WLYY0hWQ::SGhoL_fkTrGsXGJf-JIvzQ
Add a User to a Group DM (Channel Recipient)	PUT	/channels/{{channelId}}/recipients/{{userId}}	conn_mod_def::GJ2V2Bf0VtU::Yu5so1GSQMWaueJuZlhdjQ
Create a DM Channel for the Current User	POST	/users/@me/channels	conn_mod_def::GJ2V49VsbDQ::RPCntZ8aQOCAOfvJ93aT4w
Delete a Channel	DELETE	/channels/{{channelId}}	conn_mod_def::GJ2V88GpK_c::DrYq-kQyRMWnsnK7NfRz_Q
Remove a Recipient from a Group DM Channel	DELETE	/channels/{{channelId}}/recipients/{{userId}}	conn_mod_def::GJ2V9ZeRiNQ::Okd3FJ6oQ76ylFwG17tI4Q
Trigger a Channel’s Typing Indicator	POST	/channels/{{channelId}}/typing	conn_mod_def::GJ2WQYrAck0::RbcASDApS1q1VGDWuf9kdg
Update a Channel	PATCH	/channels/{{channelId}}	conn_mod_def::GJ2WRllA008::j7_rHtFqRFSIiuaLIRffTg

GuildMembers

Action	Method	Path	Action id
Get a Guild Member	GET	/guilds/{{guildId}}/members/{{userId}}	conn_mod_def::GJ2WED6lS4M::IOIOGR_oRJGtEsLZP5aJDQ
Get the Current User’s Guild Member	GET	/users/@me/guilds/{{guildId}}/member	conn_mod_def::GJ2WGsDlt8Y::ppoAmNAgSQmLJE81yiaTIA
List a Guild’s Members	GET	/guilds/{{guildId}}/members	conn_mod_def::GJ2WL9_3B4c::qeGk9doXRGOhy4iuNBlODw
Search a Guild’s Members	GET	/guilds/{{guildId}}/members/search	conn_mod_def::GJ2WPde3BuM::DAWPfSEUTuyCIelZ_elGzQ
Add a Guild Member	PUT	/guilds/{{guildId}}/members/{{userId}}	conn_mod_def::GJ2V2JJQQGc::hoKvs_GNRRiMT8BKlyGDwg
Remove a Guild Member	DELETE	/guilds/{{guildId}}/members/{{userId}}	conn_mod_def::GJ2V93apuCo::b-w0_6cjQEq3Yd11ehMuXg
Update a Guild Member	PATCH	/guilds/{{guildId}}/members/{{userId}}	conn_mod_def::GJ2WSPzGDM0::hIDbRCcZT_W4a7eZL9S3aw

Threads

Action	Method	Path	Action id
List a Channel’s Private Archived Threads	GET	/channels/{{channelId}}/threads/archived/private	conn_mod_def::GJ2WOBkMpSw::74r9jGw9Qmm_-UhGCbeHKg
List a Channel’s Public Archived Threads	GET	/channels/{{channelId}}/threads/archived/public	conn_mod_def::GJ2WOLSrEs8::uIPGQoq-SrCpu2IQJHVDiw
List Active Threads in a Guild	GET	/guilds/{{guildId}}/threads/active	conn_mod_def::GJ2WBk8xhXw::xkY8CCQpRp-EuyEAq_FlyQ
List My Private Archived Threads in a Channel	GET	/channels/{{channelId}}/users/@me/threads/archived/private	conn_mod_def::GJ2WNq57Y1E::srXdHuQERYe-bPVExXcCHw
Search Threads in a Channel	GET	/channels/{{channelId}}/threads/search	conn_mod_def::GJ2WQQB8pRs::iqs9Th5rRoGiV_eP7qx01A
Create a Thread From a Message (in a Channel)	POST	/channels/{{channelId}}/messages/{{messageId}}/threads	conn_mod_def::GJ2V7n8yn84::XsBwpKoXRT-j3Vt1AY9tVw

WebhookMessages

Action	Method	Path	Action id
Get a Webhook Message	GET	/webhooks/{{webhookId}}/{{webhookToken}}/messages/{{messageId}}	conn_mod_def::GJ2WI-3Am1Y::0P7sBMR3RkW4uIebJ2Xngw
Get the Original Webhook Message	GET	/webhooks/{{webhookId}}/{{webhookToken}}/messages/@original	conn_mod_def::GJ2WHXf4RFc::Ku41uUewQ6-D6b8_BQHRmA
Delete a Webhook Message	DELETE	/webhooks/{{webhookId}}/{{webhookToken}}/messages/{{messageId}}	conn_mod_def::GJ2WAK0cuJI::EmAobimiSHa91N9u-LwLtw
Delete the Original Webhook Message	DELETE	/webhooks/{{webhookId}}/{{webhookToken}}/messages/@original	conn_mod_def::GJ2V_Qvk3zY::TkjT-j1dTIOzightKcSp6w
Update a Webhook Message	PATCH	/webhooks/{{webhookId}}/{{webhookToken}}/messages/{{messageId}}	conn_mod_def::GJ2WVVOpzQs::TMAobr4SRQqjYlLG-8NhQA
Update Original Webhook Message	PATCH	/webhooks/{{webhookId}}/{{webhookToken}}/messages/@original	conn_mod_def::GJ2WUZUBO_U::yxEEd-zmRFO_FoWHNWmVQg

Lobbies

Action	Method	Path	Action id
Get a Lobby	GET	/lobbies/{{lobbyId}}	conn_mod_def::GJ2WGMO0av8::NKpTrFBnQLiKwpKO_ozW5A
Create a Lobby	POST	/lobbies	conn_mod_def::GJ2V6o7ngFI::dy3jLqLQQN2p2zw2MY6gSA
Create or Join a Lobby	PUT	/lobbies	conn_mod_def::GJ2V7AOd1no::sB3HGldnTuCz05tlAwacvg
Edit a Lobby	PATCH	/lobbies/{{lobbyId}}	conn_mod_def::GJ2WAp25L4E::8mOAVRx_T_yPtkVvdNVa3A
Edit a Lobby’s Linked Channel	PATCH	/lobbies/{{lobbyId}}/channel-linking	conn_mod_def::GJ2WA1tGrDE::CaSSIv0rQ1WwdGMHWO8MVQ
Leave the Current User’s Lobby	DELETE	/lobbies/{{lobbyId}}/members/@me	conn_mod_def::GJ2WJyD1AmM::BNsRjKbiQlG9GpHSTMJGCQ

ThreadMembers

Action	Method	Path	Action id
Get a Thread Member (in a Channel)	GET	/channels/{{channelId}}/thread-members/{{userId}}	conn_mod_def::GJ2WIUyrSbk::7Dd-MKZNTYiCDTQ770kkHw
List a Thread’s Members	GET	/channels/{{channelId}}/thread-members	conn_mod_def::GJ2WOd0ugLA::c6v9EOGMTAqbNRBHkFzt2g
Add a Member to a Thread (Channel)	PUT	/channels/{{channelId}}/thread-members/{{userId}}	conn_mod_def::GJ2V2xMz7dM::44het92sRemWJublll0tIA
Join a Thread (Current User)	PUT	/channels/{{channelId}}/thread-members/@me	conn_mod_def::GJ2WJhe-ymY::BixocxtGR6KmhjeEA0a5Sg
Leave a Thread (Current User)	DELETE	/channels/{{channelId}}/thread-members/@me	conn_mod_def::GJ2WJ6Y5JoQ::t6hKexwPQoW3I0zhekOmyQ
Remove a Thread Member from a Channel Thread	DELETE	/channels/{{channelId}}/thread-members/{{userId}}	conn_mod_def::GJ2V_n0BxDM::UOLz4lLLRCSJKkHsPXuk_g

GuildTemplates

Action	Method	Path	Action id
Get a Guild Template	GET	/guilds/templates/{{code}}	conn_mod_def::GJ2WE63qu_4::hNPOtqcsRVW7NCk_LSeHwA
List a Guild’s Templates	GET	/guilds/{{guildId}}/templates	conn_mod_def::GJ2WM1DIW0k::Ik8uP4mDQdiHOPHinD9DQA
Create a Guild Template	POST	/guilds/{{guildId}}/templates	conn_mod_def::GJ2V6IwU1Rs::HM8PvqCtTwSelL-ylc9aPQ
Delete a Guild Template	DELETE	/guilds/{{guildId}}/templates/{{code}}	conn_mod_def::GJ2V-qvwJKo::UZ7pFHczQiGpgTGzL7I99g
Sync a Guild Template	PUT	/guilds/{{guildId}}/templates/{{code}}	conn_mod_def::GJ2WQCazJos::lFnDd37IQdGrzWZ8zITA-Q
Update a Guild Template	PATCH	/guilds/{{guildId}}/templates/{{code}}	conn_mod_def::GJ2WS7T2Dm4::h-C5P2koSSugLBHNCkojQQ

GuildBans

Action	Method	Path	Action id
Get a Guild Ban	GET	/guilds/{{guildId}}/bans/{{userId}}	conn_mod_def::GJ2WD19Xmhw::D4EfG6bZTM2OJbnmykd9Wg
List a Guild’s Bans	GET	/guilds/{{guildId}}/bans	conn_mod_def::GJ2WLQK85sc::SXoUHsNdQqO1SHJWn8aKyQ
Ban a User from a Guild	PUT	/guilds/{{guildId}}/bans/{{userId}}	conn_mod_def::GJ2V3BIxalw::qEeUL0FHReWFAl6gCVBJYg
Bulk Ban Users From a Guild	POST	/guilds/{{guildId}}/bulk-ban	conn_mod_def::GJ2V3ZeUTmE::4_qFYiDCTLGeRdl4ThS44A
Unban a User From a Guild	DELETE	/guilds/{{guildId}}/bans/{{userId}}	conn_mod_def::GJ2WQh5VGj4::_a1iNXIDQDC3JnmLwNevtQ

GuildRoles

Action	Method	Path	Action id
Get a Guild's Role Member Counts	GET	/guilds/{{guildId}}/roles/member-counts	conn_mod_def::GJ2WJJ7LXgQ::ti5kjwvUTw-Bxo_qvGeiVQ
Bulk Update a Guild’s Role Positions	PATCH	/guilds/{{guildId}}/roles	conn_mod_def::GJ2V4GBmbTs::ScMuCMIsS7WEagHsHWpiRw
Create a Guild Role	POST	/guilds/{{guildId}}/roles	conn_mod_def::GJ2V5oTa6sg::6AJQtKi7QCag68os0JNQIg
Delete a Guild Role	DELETE	/guilds/{{guildId}}/roles/{{roleId}}	conn_mod_def::GJ2V-JGox-M::pVyBs3b8QeqyK4OS3XatdA
Update a Guild Role	PATCH	/guilds/{{guildId}}/roles/{{roleId}}	conn_mod_def::GJ2WSbPow1o::LDzA-EwIStqGK1LI1xDtFQ

GuildScheduledEvents

Action	Method	Path	Action id
Get a Guild Scheduled Event	GET	/guilds/{{guildId}}/scheduled-events/{{guildScheduledEventId}}	conn_mod_def::GJ2WEjqSIp0::xhU8Kb5ETYuxElbWzJdKNQ
List a Guild’s Scheduled Events	GET	/guilds/{{guildId}}/scheduled-events	conn_mod_def::GJ2WMeKtZMo::UO4H_0nvQqCTL45dqdbOLA
Create a Guild Scheduled Event	POST	/guilds/{{guildId}}/scheduled-events	conn_mod_def::GJ2V5v8cnaM::NFb4amoHQCKLgOa3DqcsOQ
Delete a Guild Scheduled Event	DELETE	/guilds/{{guildId}}/scheduled-events/{{guildScheduledEventId}}	conn_mod_def::GJ2V-RKqs6Q::ZP89x9FlQmG0jOU9KsPXyA
Update a Guild Scheduled Event	PATCH	/guilds/{{guildId}}/scheduled-events/{{guildScheduledEventId}}	conn_mod_def::GJ2WSkBcvKU::TRTdvQ_hTd6zfvo_d9fjsg

ApplicationEmojis

Action	Method	Path	Action id
Get an Application Emoji	GET	/applications/{{applicationId}}/emojis/{{emojiId}}	conn_mod_def::GJ2WCHW-xhM::FK2mA952Rbuu-teOj822Rg
List an Application’s Emojis	GET	/applications/{{applicationId}}/emojis	conn_mod_def::GJ2WKOO86ls::U3hoL3sKTG6XJnbLPWlMmw
Create an Application Emoji	POST	/applications/{{applicationId}}/emojis	conn_mod_def::GJ2V4j5UPAQ::jlUKN7FfSK2Tk1J3rcPiaQ
Delete an Application Emoji	DELETE	/applications/{{applicationId}}/emojis/{{emojiId}}	conn_mod_def::GJ2V8ksGNVw::_fKrG3PySdeLi9O8q_4zrQ
Update an Application Emoji	PATCH	/applications/{{applicationId}}/emojis/{{emojiId}}	conn_mod_def::GJ2WRCUkGHc::3PxzCmgbQjejyMifkZAk2Q

Applications

Action	Method	Path	Action id
Get an Application	GET	/applications/{{applicationId}}	conn_mod_def::GJ2WB1g4rOE::zI8ZYwktSUy_6IBKxtMc3A
Get My Application	GET	/applications/@me	conn_mod_def::GJ2WGkNyvIs::nQAAxpCRRLC-2eYEpGyBeA
Update an Application	PATCH	/applications/{{applicationId}}	conn_mod_def::GJ2WQojidOc::_03BGeb9RbqVT2RTfIKf-Q
Update an Application’s Role Connections Metadata	PUT	/applications/{{applicationId}}/role-connections/metadata	conn_mod_def::GJ2WRLPYfcs::JxIw_aq9SV-w5IGZ08Deqg
Update My Application	PATCH	/applications/@me	conn_mod_def::GJ2WT6TnM_Y::u_s48-42SWGky4wxcf9LpQ

This lists 90 of 229 actions. For anything not here, call search_one_platform_actions with platform discord. The full catalog is at https://www.withone.ai/knowledge/discord.

When a call fails

The error comes from Discord, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/discord

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.