Find channel by name
discord_
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_ to see every channel grouped by category.
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). |
| namerequired | string | none | Case-insensitive substring to match against channel names. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| matchesrequired | array of objects |
| id (nested, level 1)required | string |
| name (nested, level 1)required | string |
| type (nested, level 1)required | string |
| hiddenChannelsrequired | integer |
| note | string |
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
}
}