> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mantle.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> Access user profile, guilds, and OAuth2 authorization info

Connect your Discord account and give your agents access to user profiles, guild memberships, invite details, and
connection information. For full bot capabilities — sending messages, managing channels, roles, and members — see the
separate Discord Bot integration.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="User and profile access" icon="user">
    Retrieve your own Discord profile, connected accounts, and OAuth2 authorization details.
  </Card>

  <Card title="Guild information" icon="server">
    List guilds you belong to and retrieve your membership details for any server.
  </Card>

  <Card title="Invite and template lookup" icon="link">
    Resolve invite codes and preview guild templates before joining.
  </Card>

  <Card title="Community features" icon="icons">
    Browse sticker packs, view guild widgets, and access gateway information.
  </Card>
</CardGroup>

***

## Connect Discord

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Discord**.
  </Step>

  <Step title="Authorize with Discord">
    Click **Connect** and sign in with your Discord account. Grant the requested permissions so Mantle can access your
    profile and guild information.
  </Step>

  <Step title="Add Discord to an agent">Open the agent and enable only the Discord actions it needs.</Step>
</Steps>

***

## Agent tools

### User profile

| Tool                        | Description                                      |
| --------------------------- | ------------------------------------------------ |
| Get my user                 | Retrieve the connected user's Discord profile    |
| Get user                    | Look up another user's public profile            |
| Get OAuth2 authorization    | View the current OAuth2 authorization details    |
| Get OpenID Connect userinfo | Retrieve identity information via OpenID Connect |
| List my connections         | List linked accounts (Twitch, GitHub, etc.)      |

### Guilds

| Tool                | Description                                            |
| ------------------- | ------------------------------------------------------ |
| List my guilds      | List all servers the connected user belongs to         |
| Get my guild member | Retrieve your membership details for a specific server |

### Invites and templates

| Tool               | Description                               |
| ------------------ | ----------------------------------------- |
| Get invite         | Look up details of an invite code         |
| Resolve invite     | Resolve an invite link to its destination |
| Get guild template | Preview a server template before using it |

### Discovery

| Tool               | Description                                       |
| ------------------ | ------------------------------------------------- |
| Get gateway        | Retrieve the Discord gateway URL                  |
| Get guild widget   | Fetch a server's widget data                      |
| List sticker packs | Browse available sticker packs                    |
| Get public keys    | Retrieve application public keys for verification |

***

## Triggers

<Note>
  Triggers are not yet available for Discord. When trigger support is added, you will be able to start agent tasks
  automatically based on Discord activity.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Audit your server memberships">
    Ask your agent to list all guilds you belong to, summarize each one's member count and purpose, and flag any servers
    you may want to leave.
  </Accordion>

  <Accordion title="Check an invite before sharing it">
    Give your agent a Discord invite link and have it resolve the invite, showing the target server name, member count,
    and expiration details.
  </Accordion>

  <Accordion title="List your connected accounts">
    Ask your agent to retrieve all linked accounts (GitHub, Twitch, Spotify, etc.) from your Discord profile for a quick
    audit.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth flow fails">
    Make sure you are signing in with the correct Discord account. If the flow stalls, try clearing your browser cookies
    for discord.com and reconnect from **Settings → Integrations → Discord**.
  </Accordion>

  <Accordion title="Cannot see all my guilds">
    The integration only returns guilds for the connected account. If you have multiple Discord accounts, make sure you
    authorized the correct one.
  </Accordion>

  <Accordion title="Guild widget data is empty">
    The server owner must enable the widget in **Server Settings → Widget**. If the widget is disabled, the API returns
    limited or no data.
  </Accordion>

  <Accordion title="Need full bot capabilities (sending messages, managing roles)?">
    This integration provides user-level OAuth access. For full bot capabilities like sending messages, managing
    channels, and moderating members, connect the **Discord Bot** integration instead using a bot token.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>