discord-mcp

Get server info

discord_get_guild_info

Read-only

Toolset
Discovery discovery
Context cost
316 tokens, estimated1,265 bytes of definition, divided by 4

Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. The owner field is a user ID. roleCount includes the @everyone role. channelCount also counts the threads in the bot's cache. With DISCORD_GUILD_MEMBERS=false, memberCount is not updated after the bot connects. Use discord_get_server_stats for a finer breakdown (humans vs bots, channel types).

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
idrequiredstring
namerequiredstring
descriptionrequiredstring or null
memberCountrequirednumber
channelCountrequirednumber
roleCountrequirednumber
boostLevelrequirednumber
boostCountrequirednumber or null
createdAtrequiredstring
ownerrequiredstring

Related tools

Named in its description

Also in Discovery

Raw definition (1,265 bytes)
{
  "name": "discord_get_guild_info",
  "description": "Get details about one server: name, description, member/channel/role counts, boost tier, owner, and creation date. The owner field is a user ID. roleCount includes the @everyone role. channelCount also counts the threads in the bot's cache. With DISCORD_GUILD_MEMBERS=false, memberCount is not updated after the bot connects. Use discord_get_server_stats for a finer breakdown (humans vs bots, channel types).",
  "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": {
      "id": {
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "description": {
        "type": [
          "string",
          "null"
        ]
      },
      "memberCount": {
        "type": "number"
      },
      "channelCount": {
        "type": "number"
      },
      "roleCount": {
        "type": "number"
      },
      "boostLevel": {
        "type": "number"
      },
      "boostCount": {
        "type": [
          "number",
          "null"
        ]
      },
      "createdAt": {
        "type": "string"
      },
      "owner": {
        "type": "string"
      }
    },
    "required": [
      "id",
      "name",
      "description",
      "memberCount",
      "channelCount",
      "roleCount",
      "boostLevel",
      "boostCount",
      "createdAt",
      "owner"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Get server info",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}