discord-mcp

List members

discord_list_members

Read-only

Toolset
Members members
Context cost
397 tokens, estimated1,588 bytes of definition, divided by 4

List members of a server with their roles, ordered by user ID. Returns { members: [...], nextCursor }. A page holds up to 1000 members; if nextCursor is non-null, pass it back as `after` to fetch the next page. Use discord_search_members to find specific members by name, or discord_get_member_info for one member's full details. Read-only.

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).
limitoptionalinteger
1 to 1000default 50
How many members per page (1–1000). Default 50.
afteroptionalstring
pattern ^\d{17,20}$
Pagination cursor: a user ID (snowflake). Pass the previous response's nextCursor to fetch the next page.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
membersrequiredarray of objects
id (nested, level 1)requiredstring
username (nested, level 1)requiredstring
nickname (nested, level 1)requiredstring or null
roles (nested, level 1)requiredarray of objects
id (nested, level 2)requiredstring
name (nested, level 2)requiredstring
joinedAt (nested, level 1)requiredstring or null
nextCursorrequiredstring or null

Related tools

Named in its description

Also in Members

Raw definition (1,588 bytes)
{
  "name": "discord_list_members",
  "description": "List members of a server with their roles, ordered by user ID. Returns { members: [...], nextCursor }. A page holds up to 1000 members; if nextCursor is non-null, pass it back as `after` to fetch the next page. Use discord_search_members to find specific members by name, or discord_get_member_info for one member's full details. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "limit": {
        "default": 50,
        "description": "How many members per page (1–1000). Default 50.",
        "type": "integer",
        "minimum": 1,
        "maximum": 1000
      },
      "after": {
        "description": "Pagination cursor: a user ID (snowflake). Pass the previous response's nextCursor to fetch the next page.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      }
    },
    "required": [
      "guild_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "members": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "username": {
              "type": "string"
            },
            "nickname": {
              "type": [
                "string",
                "null"
              ]
            },
            "roles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name"
                ],
                "additionalProperties": false
              }
            },
            "joinedAt": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "username",
            "nickname",
            "roles",
            "joinedAt"
          ],
          "additionalProperties": false
        }
      },
      "nextCursor": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "members",
      "nextCursor"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List members",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}