> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> Deploy agents to Discord for community support and moderation.

The Discord integration connects any Agno agent to Discord via the Gateway API, so you don't need to set up webhooks.

## Quick Start

```python discord_agent.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.integrations.discord import DiscordClient

agent = Agent(name="Assistant", model=OpenAIResponses(id="gpt-5.4"))

discord_client = DiscordClient(agent)

if __name__ == "__main__":
    discord_client.serve()
```

```bash theme={null}
uv pip install agno discord.py openai
python discord_agent.py
```

## How It Works

| Concept | Behavior |
| - | - |
| **Gateway** | Direct connection to Discord, no webhooks or tunnels needed |
| **Threads** | Auto-creates threads for conversations with isolated context |
| **Intents** | Requires Message Content Intent enabled in Developer Portal |
| **Permissions** | Send Messages, Read History, Create Threads, Attach Files |

## Setup

You need a Discord Application with a bot user. Create one in the [Discord Developer Portal](https://discord.com/developers/applications).

Then set your bot token as an environment variable:

```bash theme={null}
export DISCORD_BOT_TOKEN="..."
```

## Next Steps

> **[Full Guide](https://agno-v2.mintlify.site/integrations/discord/overview.md)**
>
> Bot setup, threads, intents, and permissions.

> **[Examples](https://agno-v2.mintlify.site/integrations/discord/usage/basic.md)**
>
> Basic agent, media handling, and user memory.

> **[DiscordTools](https://agno-v2.mintlify.site/tools/toolkits/social/discord.md)**
>
> Give agents channel, message, and reaction capabilities.

> **[Discord Developer Portal](https://discord.com/developers/applications)**
>
> Create and manage your Discord application.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.