discord-mcp

List bans

discord_list_bans

Read-only

Toolset
Members members
Context cost
321 tokens, estimated1,283 bytes of definition, divided by 4

List the users banned from the server, with their ban reasons. Returns { bans: [...], nextCursor }. A page holds up to 1000 bans; if nextCursor is non-null, pass it back as `after` to fetch the next page. Requires the Ban Members or View Audit Log permission. 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 1000
Max bans per page (1–1000). Default 1000.
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
bansrequiredarray of objects
user_id (nested, level 1)requiredstring
username (nested, level 1)requiredstring
reason (nested, level 1)requiredstring or null
nextCursorrequiredstring or null

Related tools

Also in Members

Raw definition (1,283 bytes)
{
  "name": "discord_list_bans",
  "description": "List the users banned from the server, with their ban reasons. Returns { bans: [...], nextCursor }. A page holds up to 1000 bans; if nextCursor is non-null, pass it back as `after` to fetch the next page. Requires the Ban Members or View Audit Log permission. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "limit": {
        "default": 1000,
        "description": "Max bans per page (1–1000). Default 1000.",
        "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": {
      "bans": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "user_id": {
              "type": "string"
            },
            "username": {
              "type": "string"
            },
            "reason": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "user_id",
            "username",
            "reason"
          ],
          "additionalProperties": false
        }
      },
      "nextCursor": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "bans",
      "nextCursor"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List bans",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}