discord-mcp

Kick member

discord_kick_member

Destructive

Toolset
Members members
Discord permission
Kick Members
Context cost
216 tokens, estimated865 bytes of definition, divided by 4

Remove a member from the server. They can rejoin with a new invite (unlike a ban). Requires the Kick Members permission, and the bot's top role must be higher than the target's. Use discord_ban_member to block re-entry. The reason is recorded in the audit log.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
IdempotentidempotentHintnoRepeating the call can have an additional effect.
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).
user_idrequiredstring
pattern ^\d{17,20}$
Discord user ID (snowflake) of the member to kick.
reasonoptionalstring
none
Optional reason recorded in the server audit log.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Named in its description

Also in Members

Raw definition (865 bytes)
{
  "name": "discord_kick_member",
  "description": "Remove a member from the server. They can rejoin with a new invite (unlike a ban). Requires the Kick Members permission, and the bot's top role must be higher than the target's. Use discord_ban_member to block re-entry. The reason is recorded in the audit log.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "user_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord user ID (snowflake) of the member to kick."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "guild_id",
      "user_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Kick member",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}