Skip to content

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 identitydiscord_get_my_user returns username, global display name, user ID, locale, and email (only if the email OAuth scope was granted).
  • List your servers (guilds)discord_list_my_guilds enumerates every server you're a member of, with snowflake IDs, owner flag, permissions, optional member/presence counts, and pagination via before/after/limit (max 200 per call).
  • Inspect your role in a specific guilddiscord_get_my_guild_member returns roles, nickname, join date, and permissions inside one guild.
  • Resolve invite codes or URLsdiscord_resolve_invite accepts plain codes (abc123), vanity codes (discord-api), or full discord.gg/... URLs. Optionally include member/presence counts and a scheduled event ID.
  • Inspect guild widgetsdiscord_get_guild_widget returns the public widget JSON (server name, instant invite, online count, voice channels) for guilds that have widgets enabled.
  • Inspect guild templatesdiscord_get_guild_template fetches template metadata by code (the suffix of a discord.new/{code} URL).
  • Leave a guilddiscord_leave_guild removes you from a server. Irreversible — Alfrada confirms before executing.
  • Modify your profilediscord_modify_my_profile updates 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 connectionsdiscord_list_my_connections returns the Twitch/Spotify/Steam/YouTube accounts linked to your Discord (requires the connections OAuth scope).
  • Browse official sticker packsdiscord_list_sticker_packs returns 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/xyz123 link. 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. email is required to see your email; connections is 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_widget only 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_guild and discord_modify_my_profile always 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.

Built for the Alfrada platform.