discord-mcp

Get server stats

discord_get_server_stats

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_get_guild_info.

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.

FieldType
namerequiredstring
totalMembersrequirednumber
humansrequirednumber
botsInCacherequirednumber
channelsrequiredobject
total (nested, level 1)requirednumber
text (nested, level 1)requirednumber
voice (nested, level 1)requirednumber
categories (nested, level 1)requirednumber
rolesrequirednumber
boostLevelrequirednumber
boostCountrequirednumber
createdAtrequiredstring

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
  }
}