Discord MCP Server

Instructions

Implementation Reference

• src/discord_mcp/advanced_tool_handlers.py:543-554 (handler)

  Implements the core logic to kick a Discord member from a guild using the Discord API, fetching the guild and member then calling member.kick()

  async def handle_kick_member(discord_client, arguments: Dict[str, Any]) -> List[TextContent]:
      """Kick a member from the server"""
      guild = await discord_client.fetch_guild(int(arguments["server_id"]))
      member = await guild.fetch_member(int(arguments["user_id"]))
      
      member_name = member.display_name
      await member.kick(reason=arguments.get("reason", "Kicked via MCP"))
      
      return [TextContent(
          type="text",
          text=f"Kicked member {member_name} from {guild.name}\nReason: {arguments.get('reason', 'Kicked via MCP')}"
      )]

• src/discord_mcp/integrated_server.py:422-434 (registration)

  Registers the 'kick_member' tool with the MCP server, defining its name, description, and input schema for server_id, user_id, and optional reason.

  Tool(
      name="kick_member",
      description="Kick a member from the server",
      inputSchema={
          "type": "object",
          "properties": {
              "server_id": {"type": "string", "description": "Server ID"},
              "user_id": {"type": "string", "description": "User ID to kick"},
              "reason": {"type": "string", "description": "Reason for kick"}
          },
          "required": ["server_id", "user_id"]
      }
  ),

• src/discord_mcp/integrated_server.py:425-433 (schema)

  Defines the input schema for the kick_member tool, specifying required server_id and user_id parameters with optional reason.

  inputSchema={
      "type": "object",
      "properties": {
          "server_id": {"type": "string", "description": "Server ID"},
          "user_id": {"type": "string", "description": "User ID to kick"},
          "reason": {"type": "string", "description": "Reason for kick"}
      },
      "required": ["server_id", "user_id"]
  }