List servers
discord_
Read-only
- Toolset
- Discovery
discovery - Context cost
- 225 tokens, estimated899 bytes of definition, divided by 4
List the Discord servers (guilds) the bot is a member of (id, name, member count, icon). When DISCORD_ALLOWED_GUILDS is set, only those servers are listed. With DISCORD_GUILD_MEMBERS=false, the member count is not updated after the bot connects. Takes no arguments. Read-only. Start here to discover the guild_id needed by most other tools.
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
Takes no arguments.
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| guildsrequired | array of objects |
| id (nested, level 1)required | string |
| name (nested, level 1)required | string |
| memberCount (nested, level 1)required | number |
| icon (nested, level 1)required | string or null |
Related tools
Also in Discovery
Raw definition (899 bytes)
{
"name": "discord_list_guilds",
"description": "List the Discord servers (guilds) the bot is a member of (id, name, member count, icon). When DISCORD_ALLOWED_GUILDS is set, only those servers are listed. With DISCORD_GUILD_MEMBERS=false, the member count is not updated after the bot connects. Takes no arguments. Read-only. Start here to discover the guild_id needed by most other tools.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"guilds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"memberCount": {
"type": "number"
},
"icon": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"memberCount",
"icon"
],
"additionalProperties": false
}
}
},
"required": [
"guilds"
],
"additionalProperties": false
},
"annotations": {
"title": "List servers",
"readOnlyHint": true,
"openWorldHint": true
}
}