discord-mcp

Find channel by name

discord_find_channel_by_name

Read-only

Toolset
Discovery discovery
Context cost
369 tokens, estimated1,475 bytes of definition, divided by 4

Find channels whose name contains a substring (case-insensitive). Returns { matches: [...], hiddenChannels } with the id, name and type of every match, active threads included. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out of matches and counted in hiddenChannels; when it is above 0, a note field says a channel missing from matches may still exist. The list is empty when nothing matches. Useful for resolving a channel_id when you only know the channel's name. Use discord_list_channels to see every channel grouped by category.

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).
namerequiredstring
none
Case-insensitive substring to match against channel names.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
matchesrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
type (nested, level 1)requiredstring
hiddenChannelsrequiredinteger
notestring

Related tools

Named in its description

Also in Discovery

Raw definition (1,475 bytes)
{
  "name": "discord_find_channel_by_name",
  "description": "Find channels whose name contains a substring (case-insensitive). Returns { matches: [...], hiddenChannels } with the id, name and type of every match, active threads included. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out of matches and counted in hiddenChannels; when it is above 0, a note field says a channel missing from matches may still exist. The list is empty when nothing matches. Useful for resolving a channel_id when you only know the channel's name. Use discord_list_channels to see every channel grouped by category.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "name": {
        "type": "string",
        "description": "Case-insensitive substring to match against channel names."
      }
    },
    "required": [
      "guild_id",
      "name"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "matches": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "name",
            "type"
          ],
          "additionalProperties": false
        }
      },
      "hiddenChannels": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      },
      "note": {
        "type": "string"
      }
    },
    "required": [
      "matches",
      "hiddenChannels"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Find channel by name",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}