List members
discord_
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_ to find specific members by name, or discord_ for one member's full details. Read-only.
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). |
| limitoptional | integer | 1 to 1000default 50 | How many members per page (1–1000). Default 50. |
| afteroptional | string | 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.
| Field | Type |
|---|---|
| membersrequired | array of objects |
| id (nested, level 1)required | string |
| username (nested, level 1)required | string |
| nickname (nested, level 1)required | string or null |
| roles (nested, level 1)required | array of objects |
| id (nested, level 2)required | string |
| name (nested, level 2)required | string |
| joinedAt (nested, level 1)required | string or null |
| nextCursorrequired | string or null |
Related tools
Named in its description
Also in Members
-
Kick member, Destructive
discord_kick_ member -
Ban member, Destructive
discord_ban_ member -
Unban member, Write
discord_unban_ member -
Timeout member, Write
discord_timeout_ member -
Set nickname, Write
discord_set_ nickname -
List bans, Read-only
discord_list_ bans -
Bulk ban, Destructive
discord_bulk_ ban -
Prune inactive members, Destructive
discord_prune_ 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
}
}