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

# Discord

> Connect Discord to your Atako agents — 15 read and 16 write actions.

Let your agents act in your Discord servers — send and read messages, manage channels, roles, members, threads and webhooks.

## Connection

* **Authentication**: API key (Bot token).

<Note>
  Discord Developer Portal → Applications → New Application → Bot → Reset Token, then copy the token. Under Bot, enable "Server Members Intent" if you need member listing. Invite the bot to your server via OAuth2 → URL Generator with the "bot" scope and the permissions you need (e.g. Send Messages, Manage Channels, Manage Roles, Manage Webhooks).

  See [Discord's documentation](https://discord.com/developers/applications).
</Note>

## Read actions (15)

| Action                 | Description                                                                 |
| ---------------------- | --------------------------------------------------------------------------- |
| `get_channel`          | Fetch a channel by id.                                                      |
| `get_current_user`     | Fetch the bot's own user profile (connection sanity check).                 |
| `get_guild`            | Fetch a guild (server) by id.                                               |
| `get_guild_member`     | Fetch a guild member by user id.                                            |
| `get_message`          | Fetch a single message by id.                                               |
| `get_role`             | Fetch a single guild role by id.                                            |
| `get_webhook`          | Fetch a webhook by id.                                                      |
| `list_channels`        | List all channels of a guild (server).                                      |
| `list_guild_members`   | List members of a guild (requires the Server Members intent).               |
| `list_guild_webhooks`  | List all webhooks of a guild.                                               |
| `list_guilds`          | List guilds (servers) the bot is a member of.                               |
| `list_messages`        | List recent messages in a channel (newest first).                           |
| `list_roles`           | List all roles of a guild.                                                  |
| `list_webhooks`        | List webhooks of a channel.                                                 |
| `search_guild_members` | Search guild members whose username or nickname starts with a query string. |

## Write actions (16)

| Action                       | Description                                                                                    |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| `add_guild_member_role`      | Assign a role to a guild member.                                                               |
| `create_channel`             | Create a channel in a guild (0=text, 2=voice, 4=category, 5=announcement, 13=stage, 15=forum). |
| `create_message`             | Send a message to a channel.                                                                   |
| `create_reaction`            | Add a reaction to a message as the bot (emoji is a unicode emoji or name:id for custom emoji). |
| `create_role`                | Create a role in a guild.                                                                      |
| `create_thread_from_message` | Start a thread from an existing message.                                                       |
| `create_webhook`             | Create an incoming webhook on a channel.                                                       |
| `delete_channel`             | Delete a channel (or close a thread/DM).                                                       |
| `delete_guild_member`        | Remove (kick) a member from a guild.                                                           |
| `delete_message`             | Delete a message from a channel.                                                               |
| `delete_reaction`            | Remove the bot's own reaction from a message.                                                  |
| `delete_role`                | Delete a guild role.                                                                           |
| `delete_webhook`             | Delete a webhook.                                                                              |
| `edit_message`               | Edit a previously sent message.                                                                |
| `modify_channel`             | Update a channel's settings (name, topic, category…).                                          |
| `remove_guild_member_role`   | Remove a role from a guild member.                                                             |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.