List forum channels
discord_
Read-only
- Toolset
- Forums
forums - Context cost
- 243 tokens, estimated972 bytes of definition, divided by 4
List the forum channels in a server (id, name, topic, parent category). From November 16, 2026, Discord leaves out forums the bot cannot view. Read-only. Use discord_ to see a forum's available tags, or discord_ for its posts.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| channelsrequired | array of objects |
| id (nested, level 1)required | string |
| name (nested, level 1)required | string |
| topic (nested, level 1)required | string or null |
| parentId (nested, level 1)required | string or null |
Related tools
Named in its description
-
Get forum tags, Read-only
discord_get_ forum_ tags -
List forum threads, Read-only
discord_list_ forum_ threads
Also in Forums
-
Create forum channel, Write
discord_create_ forum_ channel -
Create forum post, Write
discord_create_ forum_ post -
Get forum post, Read-only
discord_get_ forum_ post -
Reply to forum post, Write
discord_reply_ to_ forum -
Delete forum post, Destructive
discord_delete_ forum_ post -
Set forum tags, Destructive
discord_set_ forum_ tags -
Update forum post, Write
discord_update_ forum_ post
Raw definition (972 bytes)
{
"name": "discord_get_forum_channels",
"description": "List the forum channels in a server (id, name, topic, parent category). From November 16, 2026, Discord leaves out forums the bot cannot view. Read-only. Use discord_get_forum_tags to see a forum's available tags, or discord_list_forum_threads for its posts.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
}
},
"required": [
"guild_id"
],
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"channels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"topic": {
"type": [
"string",
"null"
]
},
"parentId": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"topic",
"parentId"
],
"additionalProperties": false
}
}
},
"required": [
"channels"
],
"additionalProperties": false
},
"annotations": {
"title": "List forum channels",
"readOnlyHint": true,
"openWorldHint": true
}
}