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
- Find the action in the table below, or call
search_one_platform_actions with platform discord if it is not listed.
- 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.
- 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.
withoneai