discord-mcp

List forum channels

discord_get_forum_channels

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_get_forum_tags to see a forum's available tags, or discord_list_forum_threads for its posts.

Risk and annotations

Read-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
channelsrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
topic (nested, level 1)requiredstring or null
parentId (nested, level 1)requiredstring or null

Related tools

Named in its description

Also in Forums

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
  }
}