discord-mcp

List channels

discord_list_channels

Read-only

Toolset
Discovery discovery
Context cost
259 tokens, estimated1,036 bytes of definition, divided by 4

List all channels in a server, grouped by their parent category and ordered by position. Returns a JSON object keyed by category name. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out, and discord_find_channel_by_name reports how many; a visible channel whose category is hidden is listed under "Hidden parent". Read-only. Use discord_find_channel_by_name to locate a specific channel.

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.

An object keyed by name, each value described below.

FieldType
each keyarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
type (nested, level 1)requiredstring

Related tools

Named in its description

Also in Discovery

Raw definition (1,036 bytes)
{
  "name": "discord_list_channels",
  "description": "List all channels in a server, grouped by their parent category and ordered by position. Returns a JSON object keyed by category name. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out, and discord_find_channel_by_name reports how many; a visible channel whose category is hidden is listed under \"Hidden parent\". Read-only. Use discord_find_channel_by_name to locate a specific channel.",
  "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": {},
    "additionalProperties": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "type"
        ],
        "additionalProperties": false
      }
    }
  },
  "annotations": {
    "title": "List channels",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}