Get server stats
discord_
Read-only
- Toolset
- Stats
stats - Context cost
- 426 tokens, estimated1,704 bytes of definition, divided by 4
Get a snapshot of server metrics: total members (humans vs cached bots), channel breakdown (text/voice/category), role count, boost tier and count, and creation date. Note: bots are counted from the member cache only, so botsInCache is a lower bound and humans (total minus cached bots) an upper bound. The roles count excludes @everyone. In channels, total covers every channel type plus the threads in the bot's cache, while text counts only text channels (not announcement), voice only voice channels (not stage), and categories only categories. With DISCORD_GUILD_MEMBERS=false, totalMembers is not updated after the bot connects. For the server's owner and description, use discord_.
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). |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| namerequired | string |
| totalMembersrequired | number |
| humansrequired | number |
| botsInCacherequired | number |
| channelsrequired | object |
| total (nested, level 1)required | number |
| text (nested, level 1)required | number |
| voice (nested, level 1)required | number |
| categories (nested, level 1)required | number |
| rolesrequired | number |
| boostLevelrequired | number |
| boostCountrequired | number |
| createdAtrequired | string |
Related tools
Named in its description
Stats has no other tool
Raw definition (1,704 bytes)
{
"name": "discord_get_server_stats",
"description": "Get a snapshot of server metrics: total members (humans vs cached bots), channel breakdown (text/voice/category), role count, boost tier and count, and creation date. Note: bots are counted from the member cache only, so botsInCache is a lower bound and humans (total minus cached bots) an upper bound. The roles count excludes @everyone. In channels, total covers every channel type plus the threads in the bot's cache, while text counts only text channels (not announcement), voice only voice channels (not stage), and categories only categories. With DISCORD_GUILD_MEMBERS=false, totalMembers is not updated after the bot connects. For the server's owner and description, use discord_get_guild_info.",
"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": {
"name": {
"type": "string"
},
"totalMembers": {
"type": "number"
},
"humans": {
"type": "number"
},
"botsInCache": {
"type": "number"
},
"channels": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"text": {
"type": "number"
},
"voice": {
"type": "number"
},
"categories": {
"type": "number"
}
},
"required": [
"total",
"text",
"voice",
"categories"
],
"additionalProperties": false
},
"roles": {
"type": "number"
},
"boostLevel": {
"type": "number"
},
"boostCount": {
"type": "number"
},
"createdAt": {
"type": "string"
}
},
"required": [
"name",
"totalMembers",
"humans",
"botsInCache",
"channels",
"roles",
"boostLevel",
"boostCount",
"createdAt"
],
"additionalProperties": false
},
"annotations": {
"title": "Get server stats",
"readOnlyHint": true,
"openWorldHint": true
}
}