> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/discord.md).

# discord

[Discord](https://discord.com/) is a communication platform that supports text, voice, and video interactions within servers and communities. Discord bots extend the platform’s capabilities by automating actions, responding to messages, and integrating with external systems.

With a Discord bot, you can:

* **Send messages**: Post automated updates or notifications into channels.
* **Read messages**: Retrieve recent chat messages for analysis or display.
* **Access server info**: Retrieve metadata such as server name, member count, and roles.
* **Access user info**: Fetch specific user information by their unique Discord ID.

In Agent Forge, the Discord integration allows your agents to interact with servers programmatically, automate notifications, and connect workflows with Discord communities.

### Setup Instructions

Follow these steps carefully to create a Discord bot, get your IDs, and connect everything properly.

#### Create a Discord Application and Bot

{% stepper %}
{% step %}
Go to the [Discord Developer Portal](https://discord.com/developers/applications).
{% endstep %}

{% step %}
Click **“New Application”** → give it a name and click **Create**.
{% endstep %}

{% step %}
In the left sidebar, click **“Bot”** → **“Add Bot”** → **“Yes, do it!”**
{% endstep %}

{% step %}
Under **TOKEN**, click **“Reset Token”** → copy the **Bot Token** and store it safely.

Example placeholder:

```
DISCORD_BOT_TOKEN=your_bot_token_here
```

{% endstep %}

{% step %}
Scroll down to **Privileged Gateway Intents** and enable:

* **Message Content Intent**
* **Server Members Intent** (if you want user data)
* **Presence Intent** (optional but useful for activity info)
  {% endstep %}

{% step %}
Click **Save Changes**.
{% endstep %}
{% endstepper %}

#### Invite the Bot to a Discord Server

{% stepper %}
{% step %}
In the **OAuth2 → URL Generator** section:

* Under **SCOPES**, check:
  * `bot`
  * `applications.commands`
* Under **BOT PERMISSIONS**, select:
  * `Send Messages`
  * `Read Message History`
  * `View Channels`
  * `Manage Messages` (optional)
    {% endstep %}

{% step %}
Copy the generated OAuth2 URL and open it in your browser.
{% endstep %}

{% step %}
Select a **server** you manage → click **Authorize** → complete CAPTCHA.
{% endstep %}

{% step %}
Your bot will now appear in the server’s member list.
{% endstep %}
{% endstepper %}

#### 3️⃣ Get Required IDs

You’ll need several Discord IDs for API access.

**Enable Developer Mode (one-time)**

{% stepper %}
{% step %}
Open Discord → click the **⚙️ Settings** icon → **Advanced**.
{% endstep %}

{% step %}
Turn on **Developer Mode**.
{% endstep %}
{% endstepper %}

Now you can right-click items to copy their unique IDs.

**Get the Server ID (Guild ID)**

* Right-click your **server icon** in Discord → **Copy Server ID**. : `DISCORD_SERVER_ID=123456789012345678`

**Get the Channel ID**

* Right-click the **channel name** → **Copy Channel ID**. : `DISCORD_CHANNEL_ID=123*********`

**Get a User ID**

* Right-click the **user’s profile picture or name** → **Copy User ID**. : `DISCORD_USER_ID=12345********`

### Tools

#### `discord_send_message`

Send a message to a Discord channel

**Input**

| Parameter   | Type   | Required | Description                                   |
| ----------- | ------ | -------- | --------------------------------------------- |
| `botToken`  | string | Yes      | The bot token for authentication              |
| `channelId` | string | Yes      | The Discord channel ID to send the message to |
| `content`   | string | No       | The text content of the message               |
| `serverId`  | string | Yes      | The Discord server ID (guild ID)              |

**Output**

| Parameter | Type   | Description     |
| --------- | ------ | --------------- |
| `message` | string | Message content |
| `data`    | any    | Response data   |

#### `discord_get_messages`

Retrieve messages from a Discord channel

**Input**

| Parameter   | Type   | Required | Description                                                    |
| ----------- | ------ | -------- | -------------------------------------------------------------- |
| `botToken`  | string | Yes      | The bot token for authentication                               |
| `channelId` | string | Yes      | The Discord channel ID to retrieve messages from               |
| `limit`     | number | No       | Maximum number of messages to retrieve (default: 10, max: 100) |

**Output**

| Parameter | Type   | Description     |
| --------- | ------ | --------------- |
| `message` | string | Message content |
| `data`    | any    | Response data   |

#### `discord_get_server`

Retrieve information about a Discord server (guild)

**Input**

| Parameter  | Type   | Required | Description                      |
| ---------- | ------ | -------- | -------------------------------- |
| `botToken` | string | Yes      | The bot token for authentication |
| `serverId` | string | Yes      | The Discord server ID (guild ID) |

**Output**

| Parameter | Type   | Description     |
| --------- | ------ | --------------- |
| `message` | string | Message content |
| `data`    | any    | Response data   |

#### `discord_get_user`

Retrieve information about a Discord user

**Input**

| Parameter  | Type   | Required | Description                          |
| ---------- | ------ | -------- | ------------------------------------ |
| `botToken` | string | Yes      | Discord bot token for authentication |
| `userId`   | string | Yes      | The Discord user ID                  |

**Output**

| Parameter | Type   | Description     |
| --------- | ------ | --------------- |
| `message` | string | Message content |
| `data`    | any    | Response data   |

### Notes

* Category: `tools`
* Type: `discord`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://whitepaper.aitech.io/agentforge/tools/discord.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.