Discord — Identity, Servers & Invites (Read-Only Account Surface)
May 12, 2026
Connect your Discord account and Alfrada can confirm which servers you're in, resolve any discord.gg invite code or URL, inspect public guild widgets and templates, list the Twitch/Spotify/Steam accounts linked to your Discord profile, and manage your own username/avatar. One thing to know up front: Composio's Discord toolkit is OAuth2 user-scoped — it cannot send or read channel messages, list channels, or create them. For messaging your communities, reach for Slack, Teams, or Gmail instead. Discord shines for membership audits, invite hygiene, and account housekeeping.
What you can do
- Confirm your Discord identity —
discord_get_my_userreturns username, global display name, user ID, locale, and email (only if theemailOAuth scope was granted). - List your servers (guilds) —
discord_list_my_guildsenumerates every server you're a member of, with snowflake IDs, owner flag, permissions, optional member/presence counts, and pagination viabefore/after/limit(max 200 per call). - Inspect your role in a specific guild —
discord_get_my_guild_memberreturns roles, nickname, join date, and permissions inside one guild. - Resolve invite codes or URLs —
discord_resolve_inviteaccepts plain codes (abc123), vanity codes (discord-api), or fulldiscord.gg/...URLs. Optionally include member/presence counts and a scheduled event ID. - Inspect guild widgets —
discord_get_guild_widgetreturns the public widget JSON (server name, instant invite, online count, voice channels) for guilds that have widgets enabled. - Inspect guild templates —
discord_get_guild_templatefetches template metadata by code (the suffix of adiscord.new/{code}URL). - Leave a guild —
discord_leave_guildremoves you from a server. Irreversible — Alfrada confirms before executing. - Modify your profile —
discord_modify_my_profileupdates username and/or avatar (or removes the avatar). Discord caps username changes at 2 per hour. Publicly visible — Alfrada confirms before executing. - List your third-party connections —
discord_list_my_connectionsreturns the Twitch/Spotify/Steam/YouTube accounts linked to your Discord (requires theconnectionsOAuth scope). - Browse official sticker packs —
discord_list_sticker_packsreturns Discord's Nitro sticker catalog (no auth, no per-user data — just metadata). - Connect up to three Discord accounts per workspace. Personal + main + alt is the common split. Each shows its display name or email in Integrations.
Where this shows up
- Quarterly community audit. "Which Discord servers am I still in, sorted by member count?" You used to log into the desktop client, scroll the server list, and try to remember which ones still mattered. Now you ask once and decide what to leave — Alfrada will execute the leaves one by one after you confirm.
- "Is this invite legit?" A friend pastes a
discord.gg/xyz123link. You drop it in chat: "resolve this invite and tell me what guild it's for and how many members." You know whether it's a real server or a scam before you click. - Pre-stream profile cleanup. "Change my Discord username to 'StudioHandle' and remove the placeholder avatar." One confirmation, done. The 2-changes-per-hour cap means you don't accidentally burn your quota mid-session.
- Connection inventory. "What third-party accounts are linked to my Discord? Twitch, Spotify, anything else?" Useful before revoking access in your security audit.
Try it
- "List my Discord servers with member and online counts, sorted by size."
- "Resolve discord.gg/python and tell me what server it's for."
- "Get my member info for the Acme Devs guild — what roles do I have?"
- "Show me every third-party service connected to my Discord."
- "Change my Discord username to 'NewHandle' — confirm with me first."
- "Get the public widget for guild 1234567890 so I can see how many people are online."
- "Leave the 'Old Bootcamp 2022' server — I haven't used it in months. Confirm first."
Heads up
- Connecting is just a login. Integrations → connect Discord, sign in, authorise. No developer portal, no API keys.
- No channel messaging. This is a Composio toolkit limitation, not a config gap. If you ask Alfrada to send a Discord message it will refuse and suggest Slack/Teams/Gmail rather than fake the call. If you need full Discord automation (channels, roles, bots), that requires a Discord bot token, which we don't expose here.
- OAuth scopes matter.
emailis required to see your email;connectionsis required to list Twitch/Spotify/Steam links. If you didn't grant a scope at connect time, the corresponding tool returns blanks — disconnect and reconnect to expand scopes. - Widget access is guild-gated.
discord_get_guild_widgetonly works on servers where the admin has enabled the widget in Server Settings → Widget. Otherwise Discord returns an error. - Username changes are rate-limited by Discord to 2 per hour. Alfrada won't bypass that.
- Destructive actions confirm first.
discord_leave_guildanddiscord_modify_my_profilealways pause for your approval, regardless of Safety Center mode. - Up to three Discord accounts per workspace. Pass
account_identifier(the username or email Alfrada shows in Integrations) when targeting a specific secondary account.