discord-mcp

List servers

discord_list_guilds

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

Takes no arguments.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
guildsrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
memberCount (nested, level 1)requirednumber
icon (nested, level 1)requiredstring 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
  }
}